


一 企业 级 开发 从 产品 经 理 和 设计 师 的 角度 深入 浅 出 地 介绍 Android 
App 从 开发 、 调 试 到 上 线 的 企业 级 开发 流程 

一 范例 丰富 实用 提供 3 个 主流 App 与 11 个 趣味 开发 范例 ， 每 个 范例 均 
给 出 设计 思路 与 示例 代码 

- 技术 先进 ， 涉 及 面 广 包括 卫星 导航 、Socket 通 信 、 多 点 触 控 、 百 
叶 窗 动画 、 蓝 牙 技术 、 支 付 SDK、 三 端 融 合 等 众多 热点 技术 
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内 容 简 介 


本 书 是 一 部 Android 开发 的 实战 教程 ， 由 浅 入 深 、 由 基础 到 高 级 ， 带 领 读者 一 步 一 步 走 进 App 开发 的 神奇 世界 。 

全 书 共 分 为 16 章 。 其 中 ， 前 8 章 是 基础 部 分 ， 主 要 讲解 Android Studio 的 环境 搭建 、App 开发 的 各 种 常用 
控件 、App 的 数据 存储 方式 、 如 何 调试 App 并 将 App 发 布 上 线 ; 后 8 章 是 进 阶 部 分 ， 主 要 讲解 App 开发 的 设备 操 
作 、 网 络 通信 、 事 件 、 动 画 、 多 媒体 、 融 合 技术 、 第 三 方 开发 包 、 性 能 优化 等 。 书 中 在 讲解 知识 点 的 同时 给 出 了 
大 量 实战 范例 ， 方 便 读 者 迅速 将 所 学 的 知识 运用 到 实际 开发 中 。 通 过 本 书 的 学 习 ， 读 者 能 够 掌握 3 类 主流 App 的 
基本 开发 技术 ， 包 括 购物 App〈 电 子 商务 ) 、 聊 天 App〈 即 时 通信 ) 、 打 车 App〈 交 通 出 行 ) 。 另 外 ， 能 够 学 会 开 
发 一 些 趣味 应 用 ， 包 括 简单 计算 器 、 房 贷 计算 器 、 万 年 历 、 日 程 表 、 手 机 安全 助手 、 指 南 针 、 卫 星 浑 天 仪 、 抠 图 
工具 、 动 感 影集 、 影 视 播放 器 、 音 乐 播放 器 、WIFI 共享 器 等 。 

本 书 适用 于 Android 开发 的 广大 从 业者 、 有 志 于 转型 App 开发 的 程序 员 、App 开发 的 业余 爱好 者 ， 也 可 作为 
大 中 专 院 校 与 培训 机 构 的 Android 课程 教材 。 
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推荐 F 


计算 机 的 发 展 是 以 信息 智能 化 与 小 型 化 为 进化 路 线 ， 从 IBM 庞大 的 巨型 机 到 比 
尔 盖 茨 的 个 人 电脑 , 信息 无 所 不 在 。 乔 布 斯 的 伟大 之 处 在 于 “用 一 个 手指 头 改变 世界 ”。 
当 全 世界 的 粉丝 用 苹果 手机 的 时 候 ， 移 动 开发 领域 开始 全 面 地 封闭 在 iOS 的 体系 里 。 
安 卓 作 为 移动 手机 和 设备 开放 象征 的 另 一 级 ， 更 具有 活力 和 前 途 。 

欧阳 先生 是 一 位 具有 丰富 程序 开发 经 验 的 架构 师 和 项 目 管理 者 ,平时 常常 思考 和 
总 结 21 世纪 以 来 我 国 软件 开发 者 ， 特 别 是 移动 开发 开发 工程 师 的 困惑 。 社 会 从 “一 
支 笔 的 科学 家 时 代 ” 发 展 到 “一 个 键盘 开发 App 改变 世界 ”， 对 程序 员 来 说 ， 用 自 
己 的 智慧 进行 移动 应 用 开发 是 创业 的 捷径 。 读 者 遵循 书 中 的 指引 ,很 快 能 够 登 堂 入 室 ， 
成 为 当前 安 卓 应 用 开发 的 精英 人 才 。 

本 书 对 所 有 有 志 于 进行 安 卓 系统 开发 的 人 员 而 言 具有 非常 重要 的 意义 。 








杭州 海 适 云 承 科技 有 限 公司 
董事 长 兼 首席 架构 师 
沈 英 桓 
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移动 应 用 开发 又 称 App 开发 ， 是 近年 来 的 新 兴 软 件 开发 行业 。 基 于 手机 设备 的 特性 ，App 
开发 与 服务 器 开发 、 网 页 开发 等 传统 软件 开发 有 很 大 不 同 ， 将 App 开发 相关 技术 称 为 一 门 新 
兴学 科 也 不 为 过 。 

作为 一 门 学 科 ， 必 然 要 求 建立 一 套 理 论 体系 ， 这 个 理论 体系 应 当 具 有 普遍 性 与 适用 性 ， 不 
会 随 着 工具 的 变迁 而 消亡 。App 开发 就 是 如 此 ,无 论 使 用 Android 开发 还 是 iOS FR, MRH 
的 技术 、 要 实现 的 功能 都 大 同 小 异 , 区 别 在 于 需要 使 用 不 同 的 编程 工具 进行 开发 。 对 于 用 户 来 
说 , 华为 手机 上 的 微 信 与 苹果 手机 上 的 微 信 都 是 社交 App, 这 两 个 微 信 在 功能 和 使 用 上 并 没有 
显著 区 别 。 

笔者 从 事 软件 开发 工作 十 几 年 ， 期 间 经 历 了 多 次 编程 方向 的 转型 ， 先 从 C/C++ 开发 转向 
Java 开发 ， 再 从 Java 开发 转向 Android 开发 ， 而 Android 开发 先 用 ADT 后 用 Android Studio, 
在 多 次 转型 过 程 中 , 笔者 深 深 体会 到 , 无 论 是 编程 语言 还 是 开发 工具 ,变化 的 都 是 技术 实现 手 
Bt, 而 不 是 人 类 愿景 和 系统 原理 。 人 类 愿景 是 让 生活 更 加 便捷 、 让 娱乐 更 加 丰富 ， 系 统 原理 是 
让 软件 界面 更 加 美观 、 让 运行 速度 更 加 流畅 。 

本 书 的 写作 目的 是 教会 读者 Android 开发 ， 带 领 读者 走 进 一 个 轩 新 的 学 科 领 域 。 市 面 上 的 
Android 开发 书籍 林林总总 ， 写 作风 格 各 有 千秋 ， 不 过 讲解 的 基本 是 编程 开发 ， 有 的 还 会 讲解 
项 目 管理 。 本 书 除 了 介绍 常规 的 Android 开发 外 ， 还 尝试 从 两 方面 加 以 拓展 ， 一 方面 从 产品 经 
理 的 角度 仔细 分 析 App 技术 能 帮 用 户 做 什么 事情 、 能 带 给 用 户 什么 收获 ; 另 一 方面 从 设计 师 
的 角度 详细 论述 如 何 把 千篇一律 的 页 面 变 得 生动 活泼 ， 如 何 让 某 个 功能 实现 得 更 合理 、 高 效 。 

全 书 的 内 容 编排 采用 由 浅 入 深 、 循序 渐进 的 章节 体例 , 不 但 考虑 初学 者 的 学 习 连 续 性 ， 而 
且 可 以 建立 一 个 统一 、 连 贯 的 学 科 体系 。 这 么 编排 的 好 处 是 显而易见 的 , 读者 只 要 按照 顺序 学 
2], 就 能 在 学 习 过 程 中 对 已 学 部 分 不 断 复习 巩固 ,同时 提前 预习 后 面 的 技术 点 ,一 方面 衔接 自 
然 ， 另 一 方面 提高 学 习 效率 。 比 如 第 3 章 末 尾 介绍 实战 项 目 “ 登 录 App” > RREN 4 章 开头 
介绍 如 何 实现 登录 页 面 的 记 住 密码 功能 ， 第 12 章 介绍 “动画 ”， 一 方面 为 前 一 章 的 飞 掠 横幅 
补充 动画 效果 ， 另 一 方面 为 后 一 章 的 相册 切换 动画 埋 下 伏笔 。 

全 书 可 分 为 两 大 部 分 ， 第 一 部 分 是 第 1 一 8 章 ， 主 要 介绍 Android Studio 的 环境 搭建 App 
开发 的 各 种 常用 控件 ，App 的 数据 存储 方式 。 如 何 调试 App 并 将 App 发 布 上 线 ， 这 部 分 圳 括 
了 App 开发 的 基础 知识 ， 特 别 详细 说 明 App 从 开发 到 调试 再 到 上 线 的 企业 级 开发 流程 。 第 二 





























部 分 是 第 9 一 16 章 ， 主 要 介绍 App 开发 的 高 级 部 分 ， 包 括 设备 操作 、 网 络 通信 、 事 件 、 动 画 、 
多 媒体 、 融 合 技术 、 第 三 方 开 发 包 、 性 能 优化 等 ， 这 部 分 涵盖 App 开发 的 进 阶 内 容 ， 与 第 一 
分 相 比 就 像 是 “ 鸟 枪 换 炮 ”， 让 开发 者 完成 从 游击 队 到 正规 军 的 华丽 转变 。 

建议 初学 者 和 在 校 学 生 完整 学 习 第 1 一 8 章 内 容 ， 因 为 这 部 分 包含 App 开发 的 必 备 技能 ， 
只 有 打 好 基础 , 才能 进一步 学 习 。 至 于 第 9 一 16 章 内 容 ,根据 前 面 的 学 习 情 况 和 个 人 兴趣 爱好 
选择 相应 的 章节 学 习 即 可 。 如 果 倾 向 于 学 习 工 具 类 App 的 开发 ， 就 可 以 选择 学 习 “ 第 9 章 设 
备 操作 ”“ 第 11 章 事件 ”“ 第 12 章 动画 ”“ 第 13 章 多 媒体 ”; 如 果 倾向 于 学 习 企业 类 
App 的 开发 ， 就 可 以 选择 学 习 “ 第 10 章 网 络 通信 ”“ 第 14 章 融合 技术 ” “第 15 章 第 三 方 
开发 包 ” “第 16 章 性 能 优化 ”。 

对 于 有 经 验 的 开发 者 来 说 ， 可 以 自行 选择 不 熟悉 的 知识 点 拾遗 补缺 。 另 外 ， 本 书 讲述 的 部 
分 知识 点 很 具 特 色 ， 如 卫星 导航 、Socket 通信 、 多 点 触 控 、 百 叶 窗 动画 、 音 乐 播放 器 、 蓝 牙 技 
术 、 支 付 SDK、 图 片 缓存 原理 等 ， 这 些 内 容 在 同类 Android 入 门 书籍 中 鲜 有 论述 ， 有 兴趣 的 
读者 可 重点 关注 。 

当然 , 本 书面 向 的 读者 不 仅 是 开发 人 员 和 计算 机 专业 学 生 , 也 包括 移动 互联 网 行业 的 其 他 
从 业 人 员 。 对 于 产品 经 理 来 说 , 可 以 了 解 一 下 某 个 功能 使 用 的 技术 ,看 似 简 单 的 功能 ， 也 许 并 
不 容易 实现 。 对 于 设计 师 来 说 ，“ 他 山 之 石 ， 可 以 攻 玉 ”， 可 以 参考 一 下 别人 的 实现 方式 ， 也 
许 正 好 可 以 激发 你 的 灵感 ， 其实 不 无 神 益 。 对 于 测试 人 员 来 说 , 可 以 熟悉 一 下 每 项 技术 的 优 缺 
点 ， 从 而 制订 出 更 全 面 的 测试 方案 ， 也 许 能 发 现 更 多 BUG. 

本 书 所 有 代码 都 基于 Android Studio 2.2.3 开发 ， 并 使 用 API 25 的 SDK (Android 7.1.1) 
编译 与 调试 通过 。 读 者 在 阅读 本 书 时 ， 若 对 书 中 内 容 有 疑问 ， 可 在 笔者 的 博客 
(http://blog.csdn.net/aqi00) 留言 。 

本 书 范例 的 素材 和 代码 下 载 地址 为 http://pan.baidu.com/s/1dFEFEhF〈 注 意 区 分 
数字 和 英文 字母 大 小 写 ) 。 如 果 下 载 有 问题 ， 请 发 送 电 子 邮件 至 booksaga@126.com， 邮 
件 主题 设置 为 “ 求 从 零 基 础 到 App 上 线 下 载 资源 ”。 
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"EP Android Studio 环境 搭建 


本 章 主 要 介绍 如 何在 个 人 电脑 上 安装 Android Studio 和 
相应 的 配套 环境 ， 并 通过 一 个 简单 的 App“Hello World” 演 
示 Android Studio 的 常用 操作 与 App 开发 、 运 行 的 流程 ， 还 
介绍 了 App 的 工程 结构 和 开发 过 程 中 的 准备 工作 。 
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Android Studio 开发 实战 : 从 零 基础 到 App 上线 





1.1 Android Studio 简介 


Android 是 基于 Linux 的 移动 设备 操作 系统 ， 中 文 名 为 安 卓 ， 主 要 用 于 智能 手机 与 平板 电 
脑 。Android 与 iOS 为 智能 手机 市 场 的 两 大 操作 系统 。 在 中 国 大 陆 ，Android 的 市 场 份额 更 是 
遥遥 领先 ， 据 2016 年 9 月 的 移动 系统 调研 报告 ，Android 在 中 国 的 市 场 份额 为 85%， 其 余 份 
额 为 iOS. 

早期 , 在 Android 下 开发 App 主要 使 用 Eclipse 和 基于 Eclipse 的 ADT。 不 过 Eclipse 毕竟 
是 为 Java 工程 而 生 的 开发 平台 ， 并 非 专门 用 于 Android， 所 以 先天 性 不 足 难以 避免 。 自 2015 
年 之 后 ， 谷 歌 公司 便 停 止 了 ADT 的 版 本 更 新 ， 转 而 重点 打造 自家 的 Android Studio, 

Android Studio 是 谷歌 公司 推出 的 Android 应 用 开发 环境 ， 与 基于 Eclipse 的 ADT 不 同 ， 
Android Studio 是 个 全 新 的 开发 环境 , 拥有 更 强大 的 功能 和 更 高 效 的 性 能 。 本 书 使 用 的 Android 
Studio 为 2016 年 12 H 6 日 发 布 的 2.2.3 版 本 ， 同 时 支持 Windows, Mac OS X #ll Linux, 

使 用 Android Studio 比 起 使 用 Eclipse 开发 有 如 下 好 处 : 


(1) Android Studio 使 用 v7 库 与 design 库 等 只 需 增 加 一 行 配置 ， 而 Eclipse 要 想 使 用 这 
些 库 得 引用 整个 工程 。 

(2) 高 版 本 的 SDK 与 NDK 只 支持 Android Studio， 不 支持 Eclipse。 

G) 更 多 新 功能 只 能 在 Android Studio 中 运用 ， 如 自动 保存 、 多 渠道 打包 、 整 合 版 本 管 
理 、 支 持 预 览 drawable 文件 等 。 


1.2 Android Studio 的 安装 


BEAR Android Studio 有 着 众多 优点 , 又 是 App 开发 大 趋势 的 主流 工具 , 接 下 来 就 让 我 们 一 
步 一 步 地 在 自己 的 电脑 上 安装 Android Studio。 


121 开发 机 配置 要 求 


工 欲 善 其 事 ， 必 先 利 其 器 。 要 想 保证 Android Studio 的 运行 速度 ， 开 发 用 的 电脑 配置 就 要 
跟 上 。 现 在 一 般 用 笔记 本 电脑 开发 App， 下 面 是 开发 机 的 基本 配置 : 


COD 内 存 最 低 要 求 4G， 推 荐 8G， 越 大 越 好 。 

(2) CPU 要 求 1.5GHz 以 上 ， 越 快 越 好 。 

(3) 硬盘 要 求 系统 盘 剩 余 空间 10G 以 上 ， 越 大 越 好 。 

(4) 要 求 带 无 线 网 卡 、 摄 像 头 ，USB 与 麦克 风 正 常 使 用 。 

(5) 如 果 操 作 系统 是 Windows， 那 么 建议 使 用 Windows 7 及 以 上 系统 版 本 ， 因 为 在 
Windows XP 下 安装 jdk1.8 时 ， 会 提示 Java 8 需要 更 新 版 本 的 Windows 系统 。 
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122 ”安装 依赖 的 软件 


Android Studio 作为 Android 应 用 的 开发 环境 ， 仍 然 依赖 于 JDK, SDK 和 NDK 三 种 开发 
工具 。 
1.JDK 


JDK 是 Java 语言 的 编译 器 ,全称 为 Java Development Kit, 即 Java 开发 工具 包 。 因 为 Android 
应 用 采用 Java 语言 开发 ， 所 以 开发 机 上 要 先 安装 JDK， 下 载 地 址 为 http://www.oracle.com/ 
technetwork/java/javase/downloads/index.html。JDK 建议 安装 1.8 及 以 上 版 本 ， 原 因 是 不 同 的 
Android 版 本 对 JDK 有 相应 的 要 求 ， 如 Android 5.0 默认 使 用 jdk1.7 编译 ，Android 7.0 默认 使 
用 jdkl.8 编译 。 

如 果 JDK 为 1.6 或 1.7， 而 SDK 为 最 新 版 本 ， 就 可 能 导致 如 下 问题 : 


(1) 创建 项 目 后， 浏览 布局 文件 设计 图 时 会 报错 Android N requires the IDE to be running 
with Java 1.8 or later。 

(2) 编译 项 目 失败 ， 提 示 错 误 com/android/dx/command/dexer/Main: Unsupported 
major.minor version 52.0. 

(3) 运行 App 失败 ， 提 示 错 误 compileSdkVersion 'android-24' requires JDK 1.8 or later to 
compile. 

装 好 JDK 后 ,还 要 在 环境 变量 的 系统 变量 中 添加 JAVA_HOME, 取 值 为 JDK 的 安装 目录 ， 
例如 D:\Program Files(x86)\Java\jdk1.8.0_102 。 添 加 系统 变量 CLASSPATH ， 取 值 
为 .:%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\bin。 并 在 系统 
变量 Path 末尾 添加 ;%JAVA_HOME%\bin。 


2. SDK 


SDK 是 Android 应 用 的 编译 器 ， 全 称 为 Software Development Kit， 即 软件 开发 工具 包 。 
SDK 提供 了 App 开发 的 常用 工具 合集 ， 主 要 包括 : 


e build-tools 目录 ， 存 放 各 版 本 Android 的 各 种 编译 工具 。 

e docs 目录 ， 存 放 开 发 说 明文 档 。 

e extrasandroid 目录 ,存放 兼容 低 版 本 的 新 功能 支持 库 ， 比 如 android-support-v4.jar、v7 的 
各 种 库 、v13 以 上 等 库 。 

e platforms 目录 ， 存 放 各 版 本 Android 的 资源 文件 。 

e platform-tools 目录 与 tools 目录 ,存放 常用 的 开发 辅助 工具 , 如 数据 库 管 理工 具 sqlite3.exe、 
虚拟 机 调试 监控 服务 ddms.bat、 九 官 格 图 片 制 作 工 具 draw9patch.bat 等 。 

e samples 目录 ， 存 放 各 版 本 Android 常用 功能 的 demo 源码 。 

e sources 目录 ， 存 放 各 版 本 Android 的 API 开放 接口 源码 。 

e system-images 目录 ， 存 放 模拟 器 各 版 本 的 系统 镜像 与 管理 工具 。 


SDK 可 以 单独 安装 , 也 可 以 与 Android Studio 一 起 安装 , 单独 安装 的 下 载 页 面 入 口 地 址 是 
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http://sdk.android-studio.org/。 建 议 与 Android Studio 一 起 安装 ， 因 为 这 样 避免 了 一 些 兼容 性 与 
环境 设置 问题 。 无 论 是 单独 安装 还 是 一 起 安装 ， 装 好 SDK 后 都 要 在 环境 变量 的 系统 变量 中 添 
Jill ANDROID HOME， 取 值 为 SDK 的 安装 目录 ， 例 如 D:\Android\sdk。 并 在 系统 变量 Path K 
尾 添加 ;%ANDROID_HOME%\tools。 


SDK 时 常 有 版 本 更 新 ， 可 以 打开 SDK 安装 目录 下 的 SDK Manager.exe 进行 更 新 操作 ， 该 
工具 的 管理 窗口 如 图 1-1 所 示 。 
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1-1 SDK Manager 的 管理 窗口 


首先 勾 选 需要 安装 或 更 新 的 组 件 ， 然 后 单 击 Install ** packages 按钮 。 在 下 个 弹出 的 窗口 
页 面 选中 Accept License， 然 后 单 击 Install 按钮 ， 等 待 安装 过 程 。 

如 果 遇 到 国外 的 更 新 地 址 无 法 访问 导致 安装 失败 ， 可 采用 国内 的 镜像 地 址 更 新 ， 方 法 是 
依次 选择 菜单 Tools 一 Options， 在 弹出 的 设置 窗口 的 HTTP Proxy Server 栏 填写 镜像 地 址 的 域 
4. fE HTTP Proxy Port 栏 填写 镜像 地 址 的 端口 ， 然 后 勾 选 下 面 的 Force https://... sources to be 
fetched using http://...， 具 体 的 设置 页 面 如 图 1-2 所 示 。 


Ë Android SDK Manager - Settings — 
Proxy Settings 

















HTTP Proxy Server hirrors.doraforce.net 
HITP Proxy Port 80 


Manifest Cache 


Directory: C:\Users\ouyangshen\. android 
Current Size: 1.6 MiB 


国 Use dovnload cache Clear Cache 


Others 

WiForce https://... sources to be fetched using htt 
[Ask before restarting ADB 

EZ Enable Preview Tools 

















1-2 SDK Manager 的 设置 窗口 


下 面 是 设置 页 面 可 用 的 一 个 国内 镜像 地 址 : 
腾讯 Bugly， 地 址 : mirrors.dormforce.net， 端 口 : 80 
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3. NDK 


NDK 是 C/C++ 代码 的 编译 器 ， 全 称 为 Native Development Kit， 意 即 原生 开发 工具 包 。 该 
工具 包 主 要 供 JNI 接口 使 用 ， 先 把 C/C++ 代码 编译 成 so 库 ， 然 后 由 Java 代码 通过 INT 接口 调 
用 so 库 。 

NDK 的 详细 安装 步骤 见 第 14 章 的 JNI 部 分 。 装 好 NDK 后 ， 要 在 环境 变量 的 系统 变量 中 
添加 NDK_ROOT， 取 值 为 NDK 的 安装 目录 , 例如 D:\android-ndk-r12b。 然 后 在 系统 变量 Path 
末尾 添加 ;%NDK_ROOT%。 


12.3 X Android Studio 


2016 年 12 月 8 日 ， 谷 歌 开发 者 的 中 文 网 站 上 线 了 。 国 内 开发 者 可 直接 在 该 网 站 下 载 
Android Studio, 详细 的 下 载 页 面 是 https://developer.android.google.cn/studio/index.html, 在 这 里 
可 以 找到 Android Studio 的 使 用 教程 。 推 荐 安装 带 SDK 的 Android Studio 版 本 ， 因 为 SDK 内 
含 支持 库 ， 自 己 操作 比较 费时 费力 ， 还 容易 造成 兼容 性 问题 。 

双击 下 载 完成 的 Android Studio 安装 程序 ， 弹 出 安装 界面 ， 如 图 1-3 所 示 。 全 部 勾 选 安装 
界面 中 的 选项 ， 然 后 单 击 Next 按钮 。 在 下 一 页 的 许可 同意 页 面 单 击 Agree 按钮 ， 如 图 1-4 所 
示 。 进 入 下 一 页 的 安装 路 径 配 置 页 面 ， 建 议 将 Android Studio 和 SDK 装 在 除 系统 盘 外 的 其 他 
磁盘 (比如 D E) ， 然 后 单 击 Next 按钮 。 





License Agreement 
Please review the icense terms before instaling Android Studio, 


Check the components you want to install and uncheck the components you don't want to 
install. Ch Next to continue. 





[This s the Android SOK License Agreement (the ‘Lcense Agreement”). 


Select components to install: F: (€ 
E anrod L. Introduction 


SX 
== 
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图 1-3 Android Studio 的 安装 界面 图 1-4 许可 同意 界面 


接 下 来 一 直 单 击 Next 按钮 ， 直 到 弹出 最 后 一 页 ， 单 击 Install 按钮 ， 等 待 安装 过 程 进行 。 

安装 完毕 会 跳 到 Android Studio 的 安装 向 导 界 面 如 图 1-5 所 示 。 SH Next 按钮 进入 下 一 
页 ， 如 图 1-6 所 示 。 这 里 保持 Standard 选项 ， 单 击 Next 按钮 ; 在 配置 界面 确认 SDK 的 安装 路 
径 是 否 正确 ， 确 认 完毕 继续 单 击 Next 按钮 ; 在 最 后 一 个 向 导 界 面 单 击 Finish 按钮 ， 等 待 设置 
操作 。 接 下 来 的 下 载 界面 会 自动 跳 转 到 谷歌 网 站 更 新 组 件 ， 这 里 直接 单 击 Cancel 按钮 取消 下 
载 ， 然 后 单 击 Finish 按钮 结束 设置 。 最 后 弹出 Welcome to Android Studio 欢迎 界面 ， 如 图 1-7 
所 示 。 单 击 第 一 项 的 Start a new Android Studio project 即 可 开始 你 的 Android 开发 之 旅 。 
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[7 EEC [o] NERONE n 
图 1-5 安装 向 导 一 图 1-6 安装 向 导 二 
a 


Android Studio 


3) Start a new Android Studio preject 








1-7 Android Studio 的 欢迎 界面 
注意 ， 配 置 过 程 可 能 发 生 如 下 错误 提示 : 
(1) 配置 过 程 中 提示 Your Android SDK is missing...， 请 检查 SDK 的 安装 路 径 是 否 正确 
配置 ， 同 时 检查 环境 变量 中 系统 变量 的 ANDROID_HOME 是 否 正确 设置 。 
(2) 第 一 次 打开 Android Studio 可 能 会 报错 Unable to access Android SDK add-on list， 这 
个 界面 不 用 理会 ， 单 击 Cancel 按钮 即 可 。 进 入 Android Studio 主 界面 后 ， 依 次 选择 菜单 File 
— Project Structure-- SDK Location， 在 弹出 的 窗口 中 分 别 设置 JDK. SDK. NDK 的 路 径 。 设 
置 完毕 后 再 打开 Android Studio 就 不 会 报错 了 。 
(3) 已 经 按照 安装 步骤 正确 安装 ， 运 行 Android Studio 却 总 是 打 不 开 。 请 检查 电脑 上 是 
和 否 开启 了 防火 墙 ， 建 议 关 闭 系 统 防 火 墙 及 所 有 杀毒 软件 的 防火 墙 。 关 了 防火 墙 后 再 重新 打开 
Android Studio 试 试 。 
Android Studio 2.2.3 完整 版 安装 的 SDK 只 有 Android7.1.1(API 25) 和 25.0.1 版 本 的 编译 工 
有 具 集合 。 虽 然 有 一 个 版 本 的 SDK 就 足够 应 付 开发 和 编译 ， 但 是 企业 开发 时 需要 同时 运用 多 种 
版 本 ， 以 便 测试 App 在 不 同 机 型 、 不 同 版 本 上 的 兼容 性 ， 因 此 建议 同时 安装 几 个 常用 的 SDK 
版 本 。 
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运行 SDK 安装 目录 下 的 SDK Manager.exe， 弹 出 的 窗口 显示 除了 API 25 版 本 外 ， 其 他 版 
本 的 SDK 与 编译 工具 均 未 安装 ， 如 图 1-8 所 示 。 
` Ë Android SIK Mese zi: c0 ciem 


Packages Tools 
SDK Path: D:\Android\sdk 





Packages 


iÑ Nane API — Rev. — Status z 
4 PÈ Tools. 3 
TŻ Android SDK Tocls 25.2.3 E Update available:..| 
EŻ Android SDK Platform-tools 25.0.1 E Update available:.. 
[f Android SIK Build-tools 2502 [lt installed 
I] f Android SDK Build-tcols 25.0.1 E Installed 
Ef Android SIK Puild-tools 25 Aot installed 


Android SDK Build-tools 2403 (Not installed 
Android SDK Bulld-teols 2402 (Not Installed 
















Android SIK Build-tools 24.0.1 (Not installed 

EŻ Android SIK Build-tools 24 Cot installed 

EŻ Android SIK Build-tools 280.9 C Not installed 

EŻ Android SIK Build-tools 23.0.2 Ù Mot installed 

EŻ Android SIK Build-tools 23.0.1 (Not installed 

17127 Android SIW Biild-tools 3 220.1. Not installed > 
ll z E” 
Shov: V/Jpdates/Wew V) Installed Select Nev or Uncates [tall 10 packages. 

obsolete eselect & lete 5 packages. . 








|o 


Done loading packages. 











1-8. 默认 安装 的 SDK Manager 初始 界面 


这 里 要 勾 选 Tools 复 选 框 , 拉 下 来 勾 选 Android7.0(API24) 的 SDK Platform, Android6.0(API 
23) 的 SDK Platform、Android5.1.1(API 22) 的 SDK Platform、Android5.0.1(API 21) 的 SDK 
Platform、Android4.4.2(API 19) 的 SDK Platform， 然 后 单 击 右 下 角 的 “Install ** packages...” 按 
钮 ， 耐 心 等 待 安装 更 新 。 


1.3 ”运行 小 应 用 Hello World 


成 功 安装 Android Studio 后 ， 打 开 其 界面 会 发 现 有 一 堆 菜单 和 图 标 ， 对 于 这 个 陌生 的 开发 
环境 , 读者 可 能 会 有 不 知 所 措 的 感觉 。 现在 不 逐一 讲解 每 个 菜单 和 图 标的 作用 ， 直 接 开始 第 一 
个 App 一 一 Hello World， 让 我 们 在 实践 中 边 学 边 用 ， 更 好 地 理解 和 吸收 。 


13.1 创建 新 项 目 


打开 Android Studio， 依 次 选择 菜单 File 一 New 一 New Project， 弹 出 Create New Project 窗 
口 ， 如 图 1-9 所 示 。 在 Application name 栏 输入 应 用 名 称 ， 在 Company Domain 栏 输入 公司 域 
名 ， 下 面 会 自动 合成 工程 的 包 名 ， 选 择 好 项 目 工程 的 保存 目录 ， 单 击 Next 按钮 。 
下 一 个 界面 是 目标 设备 界面 , 如 图 1-10 所 示 。 该 界面 可 选择 App 期 望 运行 在 什么 设备 上 ， 
以 及 运行 App 所 需 的 SDK 最 低 版 本 号 , Minimun SDK 右 下 方 的 文字 提示 当前 版 本 号 支持 的 设 
备 市 场 份额 。 这 里 不 做 变动 ， 按 照 默 认 勾 选 的 Phone and Tablet 即 可 ， 最 低 版 本 号 也 是 默认 的 
API 15 (支持 设备 的 市 场 份额 为 97.3%， 能 够 满足 绝 大 部 分 机 型 ) 。 然 后 单 击 Next 按钮 ， 进 
入 下 一 个 界面 ， 如 图 1-11 所 示 。 该 界面 提示 我 们 选择 初始 界面 风格 ， 这 里 还 是 保持 默认 的 选 
项 Empty Activity， 单 击 Next 按钮 。 
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图 1-9 创建 新 项 目 图 1-10 指定 目标 设备 


下 一 个 界面 是 入 口 设置 界面 ， 如 图 1-12 所 示 。 该 界面 可 输入 活动 名 称 (Activity Name) 
与 布局 名 称 onini d aia ， 正 常情 况 使 用 默认 名 称 即 可 ， 单 击 OK 按钮 ， 等 待 工程 创建 。 
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图 1-11 指定 Activity 界面 的 风格 图 1-12 设置 入 口 界面 的 名 称 


工程 创建 完毕 后 ，Android Studio 自动 打开 activity main.xml 与 MainActivity.java, 并 默认 
展示 MainActivity.java 的 源码 ， 如 图 1-13 e 
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图 1-13 默认 创建 的 MainActivity 
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MainActivity.java 上 方 的 标签 表示 该 文件 的 路 径 结构 ， 注 意 源码 左 侧 有 一 列 标签 ， 从 上 到 
下 依次 是 Project、Structure、Captures、Favorites。 单 击 Project 标签 ， 左 侧 会 展开 小 窗口 表示 
该 项 目 工程 的 目录 结构 ， 如 图 1-14 所 示 。 单 击 Structure 标签 ， 左 侧 会 展开 小 窗口 表示 该 代码 
的 内 部 方法 结构 ， 如 图 1-15 所 示 。 





[C 3BelloWorld |[japp [src [mein > D java > EJ Canellovorld) Faepp ) LJ src > LJ aain > [J jan 
|  — £ Structure T+ @- I 
R 5 至 至 | ?| 

Y Oaanifests 2313/80 opm YO = | 


E AndroidWanifest. ml ia 回忆 MainActivity 
@ ? onCreate(Bundle): void f AppConpal 





v Djava 
> 后 con. exanple.hellovorld 
> con. exanple.hellovorld (androidTest) 
> Econ. exanple.hellovorld (test) 
v Püres 
E dravable 
> [layout 
> Elnipaap 
> Elvalues 
四 exnassets 
(Ò Gradle Scripts 
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K 1-14 HelloWorld 的 工程 结构 图 1-15 MainActivity 的 方法 结构 


看 完 代码 文件 再 来 看 布局 文件 ， 单 击 activity_main.xml 标签 , 切换 到 布局 文件 设计 展示 界 
面 ,如 图 1-16 所 示 。 可 以 看 到 左 侧 多 了 一 列 Palette 窗口 ,内 部 是 各 种 布局 与 控件 列表 。 在 Palette 
窗口 下 方 有 两 个 标签 ， 分 别 是 Design 默认 选 中 ， 表 示 设 计 图 ) 和 Text (表示 源 代码 ) 。 单 
ii Text 标签 ， 切 换 到 布局 文件 的 源码 界面 ， 如 图 1-17 所 示 。 这 个 布局 文件 是 标准 的 XML 格 
式 ， 内 部 定义 d T App 页 面 LEANA iius ail 
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图 1-16 activity.xml 的 设计 图 1-17 activityxml 的 源 代码 
在 查看 activity_main.xml 的 设计 图 时 ， 可 能 会 遇 到 以 下 问题 : 


(1) 报错 Android N requires the IDE to be running with Java 1.8 or later. 
原因 是 当前 机 器 的 jdk 版 本 低 于 1.8 Cl jdk1.6 8X jdk1.7) o 
解决 办 法 : 安装 最 新 的 jdk1.8， 并 正确 配置 JDK 的 安装 路 径 。 
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(2) 报错 Rendering Problems Exception raised during rendering: com/android/util/ 
PropertiesMap (Details) 或 Rendering Problems Exception raised during rendering : 
com.android.ide.common.rendering.api.LayoutlibCallback. 

原因 不 明 ， 可 能 是 Android Studio 的 一 个 bug. 

解决 办 法 : 把 布局 设计 图 右上 方 的 编译 器 改 为 API 23， 如 图 1-18 所 示 。 
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图 1-18 更 改 布局 设计 图 的 编译 器 版 本 




















13.2 ”编译 项 目 /模块 


Android Studio 与 Eclipse 一 样 ， 如 果 代 码 没有 报错 ，Android Studio 就 会 自动 编译 ， 我 们 
只 需 直 接 运 行 项 目 即 可 。 当 然 有 时 候 我 们 想 手动 重新 编译 ， 有 以 下 3 种 编译 方式 : 


(1) 选择 菜单 Build— Make Project， 编 译 整个 项 目下 的 所 有 模块 。 
(2) 选择 菜单 Build— Make Module ***， 编 译 指定 名 称 的 模块 。 
(3) 选择 菜单 Build 一 Clean Project， 然 后 选择 菜单 Build 一 Rebuild Project， 先 清理 项 目 ， 
再 对 整个 项 目 重新 编译 。 
下 面 先 认识 一 下 任务 栏 上 的 几 个 常用 图 标 ， 后 面 会 经 常用 到 它们 。 
在 图 1-19 中， 第 4 个 竖 屏 图 标 是 AVD Manager 按钮 ， Help 
单 击 该 按钮 会 弹出 模拟 器 的 管理 窗口 ; 倒数 第 二 个 向 下 稍 Q G m m ë L? 


头 图 标 是 SDK Manager, 单 击 该 按钮 会 弹出 SDK 版 本 的 管 — 
理 窗口 。 图 1-19 任务 栏 上 的 常用 图 标 


1.3.8 ”创建 模拟 器 


所 谓 模 拟 器 ， 是 指 在 电脑 上 构造 一 个 演示 窗口 ， 模 拟 手机 屏幕 上 的 App 运行 效果 。App 
通过 编译 后 ， 要 选择 一 个 接 入 设备 来 运行 ， 依 次 选择 菜单 Run 一 Run 'app' (也 可 按 快 捷 键 
Shift-F10) , Android Studio 会 弹出 新 窗口 Select Deployment Target， 如 图 1-20 所 示 。 


fP Select Deploynent Target = 











| No USB devices cr running ewulators detected Ircubleshoot 





| | Create New Emulator | 


[ J use sme selection fer future launahes sss 





1-20 运行 App 选择 接 入 设备 
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对 初学 者 来 说 ， 一 开始 没有 可 用 的 模拟 器 ， 得 创建 新 模拟 器 ， 单 击 Create New Emulator 
按钮 ， 弹 出 模拟 器 的 配置 界面 ， 如 图 1-21 所 示 。 按 照 默认 配置 即 可 ， 单 击 Next 按钮 。 


D virman device cutie 















图 1-21 选择 模拟 器 的 分 辩 率 图 1-22 选择 模拟 器 的 SDK 版 本 


下 一 个 界面 是 SDK 版 本 的 选择 界面 ， 如 图 1-22 所 示 。 单 击 第 3 个 标签 Other Images, fE 
列表 中 选择 第 一 个 Lollipop (BI Android 5.1) ， 表 示 接 下 来 创建 的 模拟 器 是 基于 Android 5.1 
系统 的 。 如 果 读 者 的 开发 机 配置 不 是 很 优越 ， 那 么 建议 模拟 器 的 大 小 不 超过 5 寸 ， 同 时 SDK 
版 本 不 高 于 API 19， 因 为 分 辨 率 越 大 、 版 本 越 高 ， 消 耗 的 系统 资源 也 越 大 。 

单 击 Next 按钮 ， 进 入 最 后 的 确认 界面 ， 在 确认 界面 右 下 角 单 击 Finish 按钮 ， 等 待 模拟 器 
的 创建 。 


1.3.4 ”在 模拟 器 上 运行 App 


模拟 器 创建 完成 后 ， 重 新 依次 选择 菜单 Run 一 
Run 'app'， 这 时 弹出 的 窗口 中 会 出 现 刚才 创建 的 模拟 
器 ， 名 称 为 Nexus 4 API 22， 如 图 1-23 所 示 。 

选中 该 模拟 器 ， 单 击 OK 按钮 ， 等 待 Android 
Studio 启动 模拟 器 。 关 于 模拟 器 的 启动 结果 ， 可 以 查 
看 主 界面 下 方 的 提示 窗口 , 如 图 1-24 所 示 。 提示 窗口 | 
有 左右 两 个 小 窗口 ， 左 侧 窗口 的 左上 角 有 一 个 logcat | One sas sce te nus tasas ETNÜS [s=] 
标签 , 用 于 展示 App 的 运行 日 志 ; 右 侧 窗口 的 右 下 角 " 
有 一 个 Gradle Console 标签 ， 用 于 展示 App 工程 的 编 ”图 1-23 接 入 设备 界面 出 现 新 创建 的 模拟 器 
译 与 启动 情况 。 























"rss | 
图 1-24 App 运行 结果 跟踪 窗口 
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如 果 在 Gradle Console 窗口 提示 编译 或 启动 失败 ， 就 按照 提示 信息 进行 处 理 。 如 果 Gradle 
Console 窗口 提示 成 功 ， 等 待 模拟 器 启动 完成 后 ， 就 会 出 现 类 似 手机 的 模拟 器 界面 ， 如 图 1-25 
所 示 。 把 模拟 器 屏幕 下 方 中 间 的 解锁 图 像 向 上 拖 动 ， 使 得 屏幕 解锁 成 功 ， 这 时 进入 App 的 启 
动 界 面 Hello World， 如 图 1-26 所 示 。 


II S35i:Nexus 4 APT 22 NNNM 











图 125 ”模拟 器 启动 完成 屏幕 图 1-26 HelloWorld 的 启动 界面 


如 果 App 启动 界面 正常 展示 ， 那 么 恭喜 你 ， 第 一 个 Hello World App 就 这 样 成 功 了 。 都 说 
万 事 开 头 难 ， 前 面 我 们 经 过 各 种 困难 ， 终 于 搭建 好 Android Studio 的 开发 环境 ， 并 且 成 功 运行 
了 第 一 个 App 一 一 Hello World， 不 过 这 只 是 万 里 长 征 的 第 一 步 ， 接 下 来 还 有 更 奇妙 的 Android 
世界 等 着 我 们 去 探索 。 


14 App 的 工程 结构 


上 一 节 我 们 在 模拟 器 上 成 功 地 运行 了 第 一 个 App (Hello Wolrd) ， 接 下 来 好 好 研究 一 下 
它 的 工程 结构 。 每 个 App 的 工程 结构 都 差不多 ， 只 要 掌握 了 基本 结构 ， 后 面 开 发 起 来 就 会 得 
心 应 手 。 


1.4.1 工程 目录 说 明 


Android Studio 的 工程 创建 分 两 个 层级 : 第 一 个 层级 通过 菜单 File 一 New 一 New Project 创 
建 ， 这 里 的 新 项 目 是 指 新 的 工作 空间 ， 对 应 Eclipse 的 workspace: 第 二 个 层级 通过 菜单 File 
一 New 一 New Module 创建 ， 这 里 的 新 模块 是 指 一 个 单独 的 App 工程 ， 对 应 Eclipse 的 project。 
第 一 次 运行 Android Studio 都 是 选择 New Project, 表示 先 创建 一 个 工作 空间 ; 后 面 还 想 创建 新 
的 App 工程 时 ， 只 需 选 择 New Module， 表 示 在 当前 工作 空间 下 新 建 一 个 App 工程 。 

例如 ， 图 1-27 是 之 前 HelloWorld 工程 的 目录 结构 图 。 
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127 HelloWorld 工程 的 目录 结构 图 


从 结构 图 中 可 以 看 到 ， 该 工程 下 面 有 两 个 目录 : 一 个 是 app， 另 一 个 是 Gradle Scripts. H 
tB, app 下 面 又 有 3 个 子 目 录 ， 功 能 说 明 如 下 ;: 


CD manifests 子 目录 ， 下 面具 有 一 个 xml 文件 ， 即 AndroidManifestxml， 是 App 的 运行 
配置 文件 。 

(2) java 子 目 录 ， 下 面 有 3 个 com.example.hellorworld 包 ， 其 中 第 一 个 包 存 放 的 是 App 
工程 的 java 源 代 码 ， 后 面 两 个 包 存放 的 是 测试 用 的 java 代码 。 

G) res 子 目录 ， 存 放 的 是 App 工程 的 资源 文件 。res 子 目录 下 又 有 4 个 子 目 录 : 


drawable 目录 存放 的 是 图 形 描述 文件 与 用 户 图 片 。 

layout 目录 存放 的 是 App 页 面 的 布局 文件 。 

mipmap 目录 存放 的 是 启动 图 标 。 

values 目录 存放 的 是 一 些 常 量 定义 文件 ， 比 如 字符 串 常 量 strings.xml、 像 素 常量 
dimens.xml、 颜 色 常 量 colors.xml、 样 式 风格 定义 styles.xml 等 。 


Gradle Scripts 下 面 主要 是 工程 的 编译 配置 文件 ， 主 要 有 : 


(1) build.gradle， 该 文件 分 为 项 目 级 与 模块 级 两 种 ， 用 于 描述 App 工程 的 编译 规则 。 

(2) proguard-rules.pro， 该 文件 用 于 描述 java 文件 的 代码 混淆 规则 。 

(3) gradle.properties， 该 文件 用 于 配置 编译 工程 的 命令 行 参数 ， 一 般 无 须 改 动 。 

(4) settings.gradle， 配 置 哪些 模块 在 一 起 编译 。 初 始 内 容 为 include tapp, IRR iire 
App 模块 。 

(5) local.properties， 项 目的 本 地 配置 ， 一 般 无 须 改动 。 该 文件 是 在 工程 编译 时 自动 生成 
的 ， 用 于 描述 开发 者 本 机 的 环境 配置 ， 比 如 SDK 的 本 地 路 径 、NDK 的 本 地 路 径 等 。 


1.4.2 ”编译 配置 文件 build.gradle 


项 目 级 别 的 build.gradle 一 般 无 须 改动 ， 我 们 只 需 关 注 模块 级 别 的 build.gradle。 下 面 在 初 
始 的 build.gradle 文件 中 补充 文字 注释 ， 方 便 读 者 更 好 地 理解 每 个 参数 的 用 途 。 
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apply plugin: 'com.android.application' 


android ( 
/ 指定 编译 用 的 SDK 版 本 号 ， 如 25 表示 使 用 Android 7.1 编译 
compileSdkVersion 25 
// 指定 编译 工具 的 版 本 号 。 这 里 的 头 两 位 数字 必须 与 compileSdkVersion 保持 一 致 ， 具 体 的 版 本 号 
可 在 sdk 安装 目录 的 sdk\build-tools 下 找到 
buildToolsVersion "25.0.2" 


defaultConfig í 
/ 指定 该 模块 的 应 用 编号 ， 即 App 的 包 名 。 该 参数 为 自动 生成 ， 无 须 修改 
applicationld "com.example.helloworld" 
/ 指定 App 适合 运行 的 最 小 SDK 版 本 号 ， 如 15 表示 至 少 要 在 Android 4.0.3 上 运行 
minSdkVersion 15 
/ 指定 目标 设备 的 SDK 版 本 号 ， 即 该 App 最 希望 在 哪个 版 本 的 Android 上 运行 
targetSdkVersion 25 
/ 指定 App 的 应 用 版 本 号 
versionCode 1 
/ 指定 App 的 应 用 版 本 名 称 
versionName "1.0" 
J 
buildTypes í 
release í 
/ 指定 是 否 开启 代码 混淆 功能 。true 表示 开启 混淆 ，false 表示 无 须 混淆。 
minifyEnabled false 
/ 指定 代码 混淆 规则 文件 的 文件 名 
proguardFiles getDefaultProguardFile(proguard-android.txt), 'proguard-rules.pro' 


j 


/ 指定 App 编译 的 依赖 信息 
dependencies { 
/ 指定 引用 jar 包 的 路 径 
compile fileTree(dir: "libs', include: ['*.jar']) 
// 指定 单元 测试 编译 用 的 junit 版 本 号 
testCompile 'junit:junit:4.12' 
// 指定 编译 Android 的 高 版 本 支持 库 ， 如 AppCompatActivity 必须 指定 编译 appcompat-v7 库 
compile 'com.android.support:appcompat-v7:25.1.0' 
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14.3 App 运行 配置 AndroidManifest.xml 


AndroidManifest.xml 用 于 指定 App 内 部 的 运行 配置 ， 是 一 个 XML 描述 文件 ， 根 节点 为 
manifest， 根 节点 的 package 指定 了 该 App 的 包 名 。manifest 下 面 又 有 若干 子 节点 ， 分 别 说 明 
如 下 : 


(1) uses-sdk， 该 节点 有 两 个 属性 : android:minSdkVersion 和 android:targetSdkVersion。 
这 两 个 属性 是 早期 Eclipse 开发 App 时 使 用 的 ， 现 在 这 两 个 字段 改 成 放 到 build.gradle 文件 中 ， 
故而 Android Studio 不 配置 uses-sdk 也 没有 关系 。 

(2) uses-permission， 该 节点 用 于 声明 App 运行 过 程 中 需要 的 权限 名 称 。 例 如 ， 访 问 网 
络 需 要 上 网 权限 ， 拍 照 需要 摄像 头 权限 ， 定 位 需要 定位 权限 等 。 

(3) application， 该 节点 用 于 指定 App 的 自身 属性 ， 默 认 的 属性 说 明 如 下 : 


android:allowBackup, 用 于 指定 是 否 允 许 备 份 , 开发 阶段 设置 为 tue, 上 线 时 设置 为 false。 
android:icon， 用 于 指定 该 App 在 手机 屏幕 上 显示 的 图 标 。 
android:label， 用 于 指定 该 App 在 手机 屏幕 上 显示 的 名 称 。 
android:supportsRtl, 设置 为 true 表示 支持 阿拉 伯 语 /波斯 语 这 种 从 右 往 左 的 文字 排列 顺序 。 
android:theme， 用 于 指定 该 App 的 显示 风格 。 

application 节点 下 还 有 几 个 子 节点 ， 比 如 活动 activity、 服 务 service、 广 播 接收 器 receiver、 
内 容 提供 器 provider 等 ， 这 些 子 节点 的 详细 属性 会 在 后 续 章 节 详细 说 明 。 
144 在 代码 中 操纵 控件 

在 一 开始 创建 Hello World 工程 时 , Android Studio 默认 打开 了 两 个 文件 ,分 别 是 布局 文件 
activity.xml 和 代码 文件 MainActivity.java。 下 面 先 看 布局 文件 activity.xml 的 内 容 : 

<?xml version="1.0" encoding="utf-8"?> 

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:tools="http://schemas.android.com/tools" 
android:layout width-"match parent" 


android:layout height-"match parent" 
android:paddingBottom-" (i dimen/activity vertical margin" 
android:paddingLeft-"(z)dimen/activity horizontal margin" 
android:paddingRight-"(z)dimen/activity horizontal margin" 
android:paddingTop-" (dimen/activity vertical margin" 
tools:context-"com.example.helloworld.MainActivity"- 


«TextView 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:text-"Hello World!" /> 
«/RelativeLayout^ 
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这 里 可 以 看 到 xml 文件 中 只 有 两 个 节点 ,分 别 是 RelativeLayout 和 TextView。 再 仔细 看 看 ， 
有 没有 发 现 我 们 熟悉 的 Hello World? 没 错 ， 模 拟 器 App 界面 显示 的 Hello World 就 来 自 于 这 
里 ， 也 就 是 TextView 控件 的 android:text 属性 值 。 可 以 把 这 里 的 Hello World 改 为 其 他 文字 ， 
比如 “你 好 、 世 界 ” 或 1 Love Android， 改 完 保 存 文 件 后 再 依次 选择 菜单 Run 一 Run 'app'， 看 
看 App 界面 上 的 文字 是 不 是 变 成 新 的 了 ? 

当然 ， 我 们 的 目标 并 不 仅 限 于 在 布局 文件 中 修改 文字 ， 还 要 能 够 在 代码 中 修改 文字 的 内 
容 。 再 次 打开 代码 文件 MainActivity.java， 看 看 里 面 有 什么 内 容 。 该 java 文件 中 MainActivity 
类 的 内 容 如 下 : 


public class MainActivity extends AppCompatActivity { 








@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


} 


这 里 可 以 看 出 ，MainActivity.java 的 代码 内 容 很 简单 ， 只 有 一 个 MainActivity 类 ， 该 类 下 
面具 有 一 个 函数 onCreate。 注 意 onCreate 内 部 的 setContentView 方法 直接 引用 了 布局 文件 的 名 
字 activity_main， 该 方法 的 意思 是 往 App 界面 填充 activity.xml 的 布局 内 容 。 现 在 我 们 要 在 这 
里 改动 改动 ， 加 点 “绿叶 红 花 ”让 它 好 看 一 些 。 首 先 打开 activity.xml， 在 TextView 节点 下 方 
补充 一 行 android:id="@+id/tv_hello"; 然后 回 到 MainActivity.java, fE setContentView 方法 下 
面 补充 如 下 几 行 代码 : 

/获取 名 字 为 tv. hello 的 TextView 控件 

TextView tv_hello = (TextView) findViewByld(R.id.tv_hello); 
/给 TextView 控件 设置 文字 内 容 
tv_hello.setText(" 今 天 天 气 真 热 啊 ， 火 辣 辣 的 "); 

/给 TextView 控件 设置 文字 颜色 
tv_hello.setTextColor(ColorRED); 

/给 TextView 控件 设置 文字 大 小 

tv_hello.setTextSize(30); 


保存 文件 后 依次 选择 菜单 Run 一 Run 'app'， 模 拟 器 上 的 App 界面 就 变 成 了 如 图 1-28 所 示 
的 样子 。 

现在 不 但 文字 内 容 改 变 了 ， 文 字 颜 色 和 字体 大 小 也 发 生 了 变化 。 怎 么 样 ， 是 不 是 很 有 成 
就 感 呢 ? 好 的 开始 是 成 功 的 一 半 , 现在 我 们 初步 学 会 了 在 代码 中 操作 控件 , 下 一 章 进 一 步 学 习 
在 App 界面 上 人 机 交互 。 
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俗话 说 得 好 ， 磨 刀 不 误 砍 柴 工 。 


今天 天 气 真 热 啊 ， 火 后 辣 
的 





128 ”修改 文字 后 的 HelloWorld 界面 


1.5 ”准备 开始 


进入 Android 的 开发 世界 ， 也 可 以 暂时 跳 过 本 节 直 接 翻 到 第 2 章 ， 符 合 个 人 习惯 就 好 。 


1.5.1 使 用 快捷 键 
WARE Eclipse 上 进行 java 开 发 一 样 , 善 用 快捷 键 会 让 开发 者 提高 工作 效率 ,Android Studio 


也 是 一 样 ， 下 面 是 使 用 Android Studio 开发 App 常用 的 快捷 键 。 


e Ctrl+S: 保存 文件 。 


e Ctrl+Z: 撤销 上 次 的 编辑 。 


e Ctrl+Shift+Z: 重 做 上 次 的 编辑 ， 建 议 改 为 CtrlHY， 与 Eclipse, UEStudio 等 工具 保持 一 
致 。Android Studio 默认 Ctrl+Y 为 删除 当前 行 ， 这 点 不 太 好 ， 当 你 习惯 按 CtrlHY 重 做 上 


次 编辑 时 ， 系 统 却 删除 了 当前 行 ， 非 常 不 便 。 


Delete: 


Ctrl+C: 
Ctrl+X: 
Ctrl+V: 
Ctrl+A: 


Ctrl+F: 
Ctrl+R: 


复制 。 
3. 
粘贴 。 
全 选 。 
删除 。 
查询 。 
替换 。 


尽管 前 面 我 们 已 经 初步 学 会 了 通过 代码 操作 控件 ， 不 过 
为 了 后 面 介 绍 Android 更 顺利 些 , 建议 读者 先 了 解 本 节 的 准备 工作 。 如 果 读 者 已 经 迫不及待 要 
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e Ctrlt/: 注释 选中 代码 (在 每 行 代码 前 面 加 双 斜 杆 ) 。 
e Ctri+Shift+/: 注释 选中 的 代码 段 (在 选中 的 代码 段 前 面 加 “/*”， 后 面 加 “#/”) 。 
e CtrizAltrL: 格式 化 选中 的 代码 段 。 注 意 该 快捷 键 与 QQ 默认 的 热 键 (锁定 QQ ) 冲突 ， 
建议 更 换 快 捷 键 ， 或 者 删除 QQ 的 同名 热 键 。 
ShiftcF6: 重 命名 。 建 议 改 为 F2， 与 Wnidows 和 Eclipse 的 使 用 习惯 保持 一 致 。 
Alt+Enter: 给 光标 所 在 位 置 的 类 导入 相应 的 包 。 
ShiftrF10: 运行 当前 模块 。 
Ctrl+F5: 清理 并 重新 运行 当前 模块 。 

当然 ， 每 个 人 习惯 的 快捷 键 不 尽 相 同 ， 对 于 Android Studio 来 说 也 不 例外 ， 为 了 更 好 地 使 
用 快捷 键 ， 最 好 手工 修改 快捷 键 。 手 工 修改 快捷 键 的 方法 : 依次 选择 菜单 File—Settings, fE 
弹出 的 设置 窗口 中 选择 Keymap， 窗 口 右 侧 出 现 如 图 1-29 所 示 的 快捷 键 列 表 。 
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e ) Keyaap 
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129 ”快捷 键 设置 界面 


在 设置 界面 选中 某 条 快捷 键 ， 右 击 或 单 击 上 方 的 铅笔 按钮 ， 在 弹出 的 菜单 中 选择 Add 
Keyboard Shortcut， 然 后 在 键盘 上 按 你 要 设置 的 快捷 键 组 合 ， 单 击 OK 按钮 ， 即 可 完成 对 应 的 
快捷 键 设置 。 


1.5.2 安装 SVN 工具 


在 企业 里 面 开发 App 都 是 团队 合作 ， 需 要 对 代码 进行 统一 管理 ， 而 且 App 每 隔 一 两 周 便 
发 布 一 个 新 版 本 ， 这 也 要 求 做 好 工程 代码 的 版 本 控制 。 因 此 ， 企 业 开发 App 都 会 运用 版 本 控 
制 工具 管理 工程 源码 ， 最 常见 的 版 本 控制 工具 是 SVN。 

Android Studio 自 带 了 SVN 插件 (Subversion) ， 但 是 还 需要 开发 者 进行 相关 配置 才能 正 
常 使 用 SVN 功能 。 具 体 配置 步骤 如 下 : 


EED) 在 本 机 上 安装 TortoiseSVN. 
首先 下 载 TortoiseSVN 安装 包 ， 然 后 在 安装 时 选择 command line client tools， 这 样 安装 后 在 bin 
目录 下 才能 找到 命令 行 工具 svn.exe。 
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€X:302. ft Android Studio 中 配置 TortoiseSVN 的 命令 行 工具 。 

打开 Android Studio， 依 次 选择 菜单 File 一 Settings 一 Version Control 一 Subversion 一 user command 
line client， 单 击 右 侧 的 浏览 按钮 ， 选 择 本 地 安装 的 svn.exe 的 完整 路 径 。 

€I £ Android Studio 中 使 用 SVN 检 出 项 目 。 

打开 Android Studio， 依 次 选择 菜单 VCS 一 Checkout from Version Control 一 Subversion， 单 击 
Repositories 右 方 的 加 号 按钮 ， 在 弹出 的 小 窗口 中 输入 SVN 仓库 地 址 ， 单 击 OK 按钮 ， 回 到 原 窗口 单 
击 Checkout 按钮 ， 把 项 目 检 出 到 本 地 目录 。 


项 目 检 出 完毕 后 , 在 开发 过 程 中 要 及 时 把 改 好 的 代码 提交 到 SVN， 同 时 要 及 时 从 SVN 更 
新 别人 改过 的 代码 到 本 地 。 下 面 是 SVN 更 新 /提交 的 方法 : 


(1) 把 代码 提交 给 SVN 服务 器 :选中 并 右 击 工程 目录 , 依次 选择 菜单 Subversion Commit 
File.., XI] SVN 服务 器 提交 本 地 改过 的 文件 。 

(2) 从 SVN 服务 器 更 新 代码 : 选中 并 右 击 工程 目录 ， 依 次 选择 菜单 Subversion 一 Update 
File...» KIRMA SVN 服务 器 更 新 文件 到 本 地 目录 。 


15.3 ”安装 常用 插件 


在 Android Studio 中 安装 插件 的 步骤 与 Eclipse 类 似 ， 具 体 步 又 为 ， 依 次 选择 菜单 File 
Settings 一 Plugins 一 下 方 按钮 Browser repositories...» 弹出 当前 可 用 插件 列表 窗口 ,如 图 1-30 所 示 。 
Er 
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图 1-30 安装 插件 窗口 


在 安装 插件 窗口 的 Category 框 中 选择 Code tools， 然 后 选中 左边 列表 的 指定 插件 ， 再 单 击 
右边 窗口 内 部 的 Install 按钮 ， 安 装 后 重启 Studio 即 可 正常 使 用 该 插件 的 功能 。 下 面 是 5 个 常 
用 的 Studio 插件 : 

1.Android Parcelable code generator 

该 插件 可 自动 生成 Parcelable 接口 的 代码 。 开 发 者 先 写 好 一 个 类 和 内 部 变量 的 定义 ， 然 后 
在 代码 中 按 AlttInsert， 弹 出 的 菜单 列表 下 方 就 有 Parcelable 选项 ， 如 图 1-31 所 示 。 选 中 该 选 
项 ， 即 在 类 中 插入 实现 Parcelable 接口 的 代码 。 
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2.Android Code Generator 


该 插件 可 根据 布局 文件 快速 生成 对 应 的 Activity. Fragment, Adapter. Menu 等 代码 。 在 
布局 文件 上 右 击 或 者 在 布局 文件 内 部 右 击 ， 弹 出 的 菜单 中 多 了 一 个 Generate Android Code 选 
项 ， 具 体 的 菜单 如 图 1-32 所 示 。 选 中 生成 项 后 ， 便 会 弹出 代码 窗口 ， 把 已 生成 的 代码 复制 出 
来 即 可 。 注 意 该 插件 对 汉字 的 支持 不 太 好 ， 如 果 xml 文件 中 有 汉字 ， 代 码 就 会 生成 失败 。 
ublic class Person [ 

public String id; 


public String name; 
public int age; 





Generate 
GsonFormat Alt*S Co To 

Constructor Generate... Alt*Insert 
Getter @ Open in Browser 

Setter Validate 


Getter and Setter Local History 


Activity 
equals () and hashCode () Compare with Clipboard 
toString() ile Ë 1 Fragnent 
Override Methods... Ctrl+0 Generate DID from XNL File Butterknife Activity 








Delegate Methods... Generate XSD Schema from XNL File... Butterknife Adapter 
Copyright Butterknife Fragment 
Create Gist... : text 
1-31 Parcelable 插件 1-32. Generate Android Code 插件 菜单 
3. GsonFormat 


该 插件 能 够 快速 将 json 字符 串 转 换 成 代码 段 ， 包 含 变量 定义 以 及 set. get 函数 。 在 代码 
中 按 Alt+S, PHH json 格式 化 窗口 ， 往 窗口 中 粘贴 json 字符 串 ， 单 击 OK 按钮 ， 即 可 在 代码 中 
插入 生成 好 的 代码 段 。GsonFormat 窗口 如 图 1-33 所 示 。 





"lid GsonForzat. 1.2.3 iio mi" 
con. exanple. hello. RequestJson l Fo... 





['llms_app_id"*1002", 
“portalType”:"2” "portal Account" "test" "portalPwd" 123456" 'requestip"*127 0.0.1" msisdn""l 











Setting [e] BENE 


图 1-33 GsonFormat 插件 











4. Android Postfix Completion 
该 插件 支持 在 代码 中 快速 生成 Toast. Log 等 代码 行 。 开 发 者 在 代码 中 输入 字符 串 ， 后 面 
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跟 上 .toast 并 回 车 ， 即 可 生成 Toast.makeText 代码 行 ， 输 入 字符 串 后 ， 紧 接着 输入 .log 并 回 车 ， 
即 可 生成 Log.d 代码 行 ， 如 图 1-34 所 示 。 


BOverride 














protected void onCreate(Bundle savedInstanceState) ( 
super. onCreate (savedInstanceState); 
setContentVi ew(R. layout. activity main); 


TextViem tv hello = (TextViem) findViemById(R. id. tv. he110); 
Ter 4 AE 


tee 







GAKUQUNS, X58507). 


= 


xtColor(Color. RED) ; 





tv he 
tv hel 


“WRAS. 1d 





) 


图 1-34 Postfix 插件 使 用 截图 


5. Android Drawable Importer 


该 插件 可 对 一 张 图 片 自动 生成 不 同 分 辨 率 的 图 片 ， 从 ” WO Icon Pack Drawable Importer 
而 让 图 片 对 不 同 屏幕 的 适 配 工作 变 得 更 加 容易 。 右 击 任意 Wü Vector Dravable Importer 
目录 ， 在 弹出 的 菜单 中 选择 New， 右 方 弹出 的 菜单 列表 未 BEES 
尾 会 出 现 *** Drawable Importer 之 类 的 菜单 项 ， 如 图 1-35 
所 示 。 图 1-35 ”Drawable 插件 菜单 

这 里 通常 选中 Batch Drawable Import， 在 弹出 的 窗口 中 选择 图 片 的 文件 路 径 ， 并 色 选 需要 
自动 生成 的 分 辨 率 ， 然 后 单 击 OK 按钮 ， 即 可 在 drawabe 各 分 辩 率 的 目录 下 生成 对 应 的 图 片 。 


154 导入 ADT 工程 


虽然 现在 Android Studio 是 App 开发 的 主流 工具 , 但 是 之 前 有 不 少 App 是 基于 ADT 开发 
的 ， 网 络 上 也 有 许多 源码 以 ADT 工程 的 形式 提供 ， 所 以 在 开发 过 程 中 会 经 常 把 原 有 的 ADT 
工程 导入 Android Studio 环境 。 

导入 ADT 工程 的 操作 步骤 是 : 打开 Android Studio， 依 次 选择 菜单 File 一 New 一 Import 
Module, 然后 单 击 窗口 右边 的 浏览 按钮 ,选择 ADT 工程 的 路 径 , 单 击 Finish 按钮 , 等待 Android 
Studio 识别 并 导入 ADT 工程 。 如 果 导 入 成 功 ， 接 下 来 就 能 按照 正常 操作 步骤 编译 和 运行 该 工 
程 的 App 了 。 

导入 的 ADT 工程 如 果 在 运行 时 提示 “Error(1，1) 错误 : 非法 字符 : wufeff”， 是 因为 源 
代码 文件 是 带 BOM 的 utf8 格式 , 如 果 是 Eclipse 就 会 自动 将 它 识别 为 正常 的 格式 , 但 Android 
Studio 目前 还 不 会 正常 识别 ， 所 以 要 先 把 这 种 文件 转换 为 无 BOM 的 utf8 格式 。 办 法 是 打开 
UEStudio 这 类 文本 编辑 软件 ， 先 把 代码 文件 另存 为 无 BOM 的 utf 格式 文件 ， 然 后 在 Android 
Studio 中 刷新 文件 并 重新 编译 。 
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16 小 结 


本 章 主要 介绍 了 App 开发 环境 一 Android Studio 环境 的 搭建 。Android Studio 作为 一 个 
集成 开发 环境 ， 依 赖 于 3 个 开发 工具 : JDK、SDK、NDK。 从 创建 最 简单 的 HelloWorld m H 
开始 ， 依 次 介绍 了 项 目 创建 、 项 目 编译 、 模 拟 器 创建 、 在 模拟 器 上 运行 App 这 一 连 串 开发 流 
程 ,为 了 让 读者 有 更 理性 的 认识 ,又 逐步 讲解 了 App 的 工程 目录 结构 、 编 译 配置 文件 build.gradle 
的 使 用 说 明 、App 运行 配置 文件 AndroidManifest.xml 的 节点 说 明 、 如 何在 代码 中 简单 操作 控 
件 等 。 最 后 对 开发 过 程 中 的 准备 工作 做 了 必要 的 说 明 ， 主 要 包括 如 何 使 用 快捷 键 、 如 何 使 用 
SVN 进行 版 本 管理 、 如 何 安装 和 使 用 常见 插件 、 如 何 把 ADT 工程 导入 Android Studio. 

通过 本 章 的 学 习 ， 读 者 应 该 获得 了 Android Studio 的 基本 操作 技能 ， 能 够 使 用 自己 搭建 的 
Android Studio 环境 创建 简单 的 App 并 在 模拟 器 上 运行 ， 并 具备 进一步 提高 的 学 习 基 础 。 





PAT usun 


本 章 介 绍 Android 屏幕 显示 初级 视图 的 相关 知识 ,主要 
包括 屏幕 显示 基础 、 简 单 布局 的 用 法 、 简 单 控件 的 用 法 、 简 
单 图 形 的 用 法 。 并 且 结 合 本 章 所 学 的 知识 , 演示 了 一 个 实战 
项 目 “ 简 单 计算 器 ”的 设计 与 实现 。 
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2.1 屏幕 显示 


本 节 从 最 基础 的 显示 单元 开始 介绍 ， 讲 述 了 移动 设备 如 何在 屏幕 上 展现 丰富 多 彩 的 界面 。 
本 节 主 要 内 容 包 括 像素 的 几 个 常用 单位 、 颜 色 的 编码 与 使 用 、 屏 幕 分 辨 率 的 获取 等 。 


214 像素 


老子 曾 说 “天 下 难事 必 作 于 易 ， 天 下 大 事 必 作 于 细 ”，Android 开发 也 是 如 此 。 纵 使 App 
的 界面 千变万化 、 绚 丽 多 姿 ,也 都 归 因 于 数 百 万 个 像素 的 组 合 排列 ， 就 像 万 物 缘由 原子 构成 一 
般 。 像 素 看 似 简单 ， 实 际 有 大 学 问 ， 如 果 对 像素 单位 不 知 其 所 以 然 , 开发 时 只 知 一 根 筋 的 填 数 
F, 结果 在 模拟 器 上 运行 得 很 好 的 界面 ,在 真 机 上 很 可 能 显示 得 东 倒 西 焉 ,这 就 是 没 打 好 基础 
的 缘故 。 如 果 一 开始 就 把 像素 的 基本 概念 弄 清楚 ， 后面 就 会 少 走 很 多 弯路 ,开发 起 来 也 会 更 加 
得 心 应 手 。 

Android 支持 的 像素 单位 有 : px (像素 ) 、in (英寸 ) 、mm (毫米 ) pt Cj, 1/72 英寸 ) 、 
dp“〈 与 设备 无 关 的 显示 单位 ) 、dip( 就 是 dp) 、sp《〈 用 于 设置 字体 大 小 ) 。 其 中 ， 常 用 的 有 
px、dp 和 sp 三 种 。 

具体 来 说 ，px 是 手机 屏幕 上 可 显示 的 最 小 单位 ， 与 物理 设备 的 显示 屏 有 关 。 一 般 来 说 ， 同 
样 尺 寸 的 屏幕 〈 比 如 5 寸 的 手机 ) 看 起 来 越 清 晰 , 像素 的 密度 越 高 ， 以 px 计量 的 分 辨 率 也 越 大 。 

dp 与 物理 设备 无 关 ， 只 与 屏幕 的 尺寸 有 关 。 一 般 来 说 ， 同 样 尺 寸 的 屏幕 以 dp 计量 的 分 辨 
率 是 一 样 的 ， 无 论 这 个 手机 是 哪个 厂家 生产 的 ，dp 大 小 都 一 样 。 

sp 的 原理 跟 dp 差不多 ， 专门 用 于 设置 字体 大 小 。 手 机 在 系统 设置 里 可 以 调整 字体 的 大 小 
(小 、 普 通 、 大 、 超 大 ) 。 设 置 普通 字体 时 ， 同 数值 dp 和 sp 的 文字 看 起 来 一 样 大 ;如 果 设 置 
为 大 字体 ， 用 dp 设置 的 文字 没有 变化 , 用 sp 设置 的 文字 就 变 大 了 。 例如 ， 当 系统 设置 普通 字 
体 时 ，18dp 与 18sp 的 文字 一 样 大 ， 如 图 2-1 所 示 ; 当 系 统 设置 大 字体 时 ，18dp 的 文字 大 小 不 
变 ，18sp 的 文字 却 增 大 了 ， 如 图 2-2 所 示 。 





Hello World! Hello World! 
Hello World! Hello World! 











图 2-1 普通 字体 的 效果 图 图 2-2 大 字体 的 效果 图 
所 以 说 ，dp 与 系统 设置 的 字体 大 小 没有 关系 ， 而 sp 会 随 系统 设置 的 字体 大 小 变 大 或 变 小 。 
dp 和 px 之 间 的 联系 取决 于 具体 设备 上 的 像素 密度 ， 像 素 密度 就 是 DisplayMetrics 里 的 
density 参数 。 当 density=1.0 时 ， 表 示 一 个 dp 值 对 应 一 个 px 值 ; 当 density=1.5 时 ， 表 示 两 个 
dp 值 对 应 3 个 px 值 ; 当 density=2.0 时 , 表示 一 个 dp 值 对 应 两 个 px 值 。 具体 的 转换 函数 如 下 : 
public class Utils { 


// 根 据 手 机 的 分 辩 率 从 dp 的 单位 转 成 为 px( 像 素 ) 
public static int dip2px(Context context, float dpValue) { 
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final float scale = context.getResources().getDisplayMetrics().density; 
return (int) (dpValue * scale + 0.5f); 
$ 


/根据 手机 的 分 辩 率 从 px( 像 素 ) 的 单位 转 成 为 dp 

public static int px2dip(Context context. float pxValue) í 
final float scale = context.getResources().getDisplayMetrics().density; 
return (int) (pxValue / scale + 0.5f); 


) 
在 XML 布局 文件 中 ， 为 了 让 不 同 设备 屏幕 拥有 统一 的 显示 效果 ， 除 了 sp 用 于 设置 文字 
大 小 外 ， 其 余 要 用 大 小 的 地 方 都 用 dp。 在 代码 中 情况 又 有 所 不 同 ，Android 用 于 设置 大 小 的 函 
数 都 以 px 为 单位 。 无 论 是 LayoutParams 里 的 width 和 height， 还 是 setMargins 和 setPadding， 
参数 单位 都 是 px， 要 想 在 代码 中 使 用 dp 设置 布局 大 小 或 间距 ， 得 先 把 dp 值 转换 成 px 值 。 代 
码 示 例如 下 : 
int dip_10 = Utils.dip2px(this, 10L); 
TextView tv padding = (TextView) findViewBylId(R.id.tv_padding); 
tv padding.setPadding(dip 10, dip 10, dip 10, dip 10); 


24.2 颜色 


在 Android 中 ， 颜 色 值 由 透明 度 alpha 和 RGB (Z. 5, W) 三 原色 定义 ， 有 八 位 十 六 进 
制 数 与 六 位 十 六 进 制 数 两 种 编码 ， 例 如 八 位 编码 FFEEDDCC, FF 表示 透明 度 ，EE 表示 红色 
的 浓度 ，DD 表示 绿色 的 浓度 ，CC 表示 蓝 色 的 浓度 。 透 明度 为 FF 表示 完全 不 透明 ， 为 00 表 
示 完 全 透明 。RGB 三 色 的 数值 越 大 颜色 越 浓 也 就 越 亮 ， 数 值 越 小 颜色 越 暗 。 亮 到 极致 就 是 白 
色 ， 暗 到 极致 就 是 黑色 ， 这 样 记 就 不 会 摘 混 了 。 

六 位 十 六 进 制 编码 有 两 种 情况 ， 在 XML 文件 中 默认 不 透明 〈 透 明度 为 FF) ， 在 代码 中 默 
认 透 明 〈 透 明度 为 00) 。 下 面 的 代码 分 别 给 两 个 文本 控件 设置 六 位 编码 和 八 位 编码 的 背景 色 。 

TextView tv code six = (TextView) findViewById(R.id.tv_code_six); 

tv code six.setBackgroundColor(0x00ff00); 

TextView tv code eight = (TextView) findViewById(R.id.tv code eight); 
tv code eight.setBackgroundColor(Oxff00fT00); 


从 图 2-3 可 以 看 到 ,代码 使 用 六 位 编码 看 不 到 任何 背景 ， 使 用 八 位 编码 能 够 看 到 正确 的 绿 
色 背 景 。 








图 2-3 不 同方 式 设置 颜色 编码 的 效果 图 
在 Android 中 使 用 颜色 有 下 列 3 种 方式 : 
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1. 使 用 系统 已 定义 的 颜色 常量 。 


Android 系统 有 12 种 已 经 定义 好 的 颜色 , 具体 的 类 型 定义 在 Color KP, 详细 的 取 值 说 明 
见 表 2-1。 


表 2-1 颜色 类 型 的 取 值 说 明 























Color 类 中 的 颜色 类 型 Color 类 中 的 颜色 类 型 

BLACK 黑色 GREEN 绿色 
DKGRAY 深 灰 BLUE 蓝 色 
GRAY 灰色 YELLOW 黄色 
LTGRAY RK CYAN 青色 
WHITE 白色 MAGENTA 政 红 
RED TRANSPARENT 











2. 使 用 十 六 进 制 的 颜色 编码 。 


在 布局 文件 中 设置 颜色 需要 在 色 值 前 面 加 “#”， 如 android:textColor="#000000"。 在 代码 
中 设置 颜色 可 以 直接 填 八 位 的 十 六 进 制 数值 (如 setTextColor(0xff00ff00);) ， 也 可 以 通过 
Color.rgb(int red, int green, int blue) 和 Color.argb(int alpha, int red, int green, int blue) 这 两 种 方法 
指定 颜色 。 在 代码 中 一 般 不 要 用 六 位 编码 ， 因 为 六 位 编码 在 代码 中 默认 透明 ， 所 以 代码 用 六 位 
编码 跟 不 用 没什么 区 别 。 

3. 使 用 colors.xml 中 定义 的 颜色 。 


res/values 目录 下 有 个 colors.xml 文件 ， 是 颜色 常量 的 定义 文件 。 如 果 要 在 布局 文件 中 使 
用 XML 颜色 常量 ， 可 引用 “@color/ 常 量 名 ”; 如 果 要 在 代码 中 使 用 XML 颜色 常量 ， 可 通过 
这 行 代码 获取 : getResources().getColor(R.color. 常 量 名 )。 


24.3 RENIE 


在 App 编码 中 时 常 要 取 手 机 的 屏幕 分 辩 率 〈 如 当前 屏幕 的 宽 和 高 )》 ， 然 后 动态 调整 界面 
上 的 布局 。 在 代码 中 获取 分 辩 率 就 是 想 办 法 获得 DisplayMetrics 对 象 ， 然 后 从 该 对 象 中 获得 宽 
度 、 高 度 、 像 素 密度 等 信息 。 下 面 是 DisplayMetrics 类 的 常用 属性 说 明 。 


e widthPixels: 以 px 为 单位 计量 的 宽度 值 。 
e heightPixels: 以 px 为 单位 计量 的 高 度 值 。 
e density: 像素 密度 ， 即 一 个 dp 单位 包含 多 少 个 px 单位 。 


下 面 是 获取 当前 屏幕 的 宽度 、 高 度 、 像 素 密度 的 代码 示例 。 


public class DisplayUtil í 
public static int getSreenWidth(Context ctx) í 
WindowManager wm = (WindowManager) ctx.getSystemService(Context. WINDOW SERVICE); 
DisplayMetrics dm = new DisplayMetrics(); 
wm.getDefaultDisplay().getMetrics(dm); 
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return dm.widthPixels; 
t 


public static int getSreenHeight(Context ctx) { 
WindowManager wm = (WindowManager) ctx.getSystemService(Context. WINDOW SERVICE); 
DisplayMetrics dm — new DisplayMetrics(); 
wm.getDefaultDisplay().getMetrics(dm); 
return dm.heightPixels; 
上 


public static float getSreenDensity(Context ctx) í 
WindowManager wm = (WindowManager) ctx.getSystemService(Context.WINDOW_ SERVICE); 
DisplayMetrics dm = new DisplayMetrics(); 
wm.getDefaultDisplay().getMetrics(dm); 
return dm.density; 


) 
从 一 个 接 入 设备 上 获得 屏幕 分 辩 率 信息 ， 如 图 2-4 所 示 。 该 设备 为 5 寸 屏 幕 ， 分 辨 率 是 
720*1280， 像 素 密 度 是 2。 


Junior 
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22 简单 布局 











本 节 开 始 介绍 Android 的 基本 视图 和 布局 , 首先 说 明基 本 视图 View 类 的 常用 属性 和 方法 ， 
接着 描述 如 何 使 用 线性 布局 LinearLayout， 最 后 介绍 滚动 视图 ScrollView 的 用 法 。 


2.2.1 视图 View 的 基本 属性 

View 是 Android 的 基本 视图 , 所 有 控件 和 布局 都 是 由 View 类 直接 或 间接 派生 而 来 的 。 故 
而 View 类 的 基本 属性 和 方法 是 各 控件 和 布局 通用 的 ， 掌 握 好 基本 属性 和 方法 ， 在 哪里 都 能 派 
上 有 用场， 能够 举一反三 、 事 半 功 倍 。 

下 面 是 视图 在 XML 布局 文件 中 常用 的 属性 定义 说 明 。 

e id: 指定 该 视图 的 编号 。 

e layout width: 指定 该 视图 的 宽度 。 可 以 是 具体 的 dp 数值 ;可 以 是 match parent. KEHE 

级 视图 一 样 宽 ; 也 可 以 是 wrap_content， 表 示 与 内 部 内 容 一 样 宽 ( 内 部 内 容 若 超过 上 级 视图 
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的 宽度 ， 则 该 视图 保持 与 上 级 视图 一 样 帘 ， 超 出 宽度 的 内 容 得 进行 滚动 才能 显示 出 来 ) 。 
e layout height: 指定 该 视图 的 高 度 。 取 值 说 明 同 layout width. 
e layout margin: 指定 该 视图 与 周围 视图 之 间 的 空白 距离 (包括 上 、 下 、 左 、 右 ) 。 另 有 
layout marginTop. layout marginBottom. layout marginLeft. layout marginRight 分 别 表 
示 单 独 指定 视图 与 上 边 、 下 边 、 左 边 、 右 边 视图 的 距离 。 
minWidth: 指定 该 视图 的 最 小 宽度 。 














° 

e minHeight 指定 该 视图 的 最 小 高 度 。 

e background: 指定 该 视图 的 背景 。 背 景 可 以 是 颜色 ， 也 可 以 是 图 片 。 

e layout gravity: 指定 该 视图 与 上 级 视图 的 对 齐 方式 。 对 齐 方式 的 取 值 说 明 见 表 2-2， 若 同 

时 适用 多 种 对 齐 方式 ， 则 可 使 用 竖 线 “|” 把 多 种 对 齐 方式 拼接 起 来 。 
32-2 对齐 方式 的 取 值 说 明 

XML 中 的 对 齐 方 式 Gravity 类 中 的 对 齐 方 式 说 明 
left LEFT 靠 左 对 齐 
right RIGHT 靠 右 对 齐 
top TOP 向 上 对 齐 
bottom BOTTOM 向 下 对 齐 
center CENTER 居中 对 齐 
center_horizontal CENTER. HORIZONTAL 水 平方 向 居中 
center vertical CENTER VERTICAL 垂直 方向 居中 








o padding: 指定 该 视图 边缘 与 内 部 内 容 之 间 的 空白 距离 。 另 有 paddingTop、paddingBottom、 
paddingLeft. paddingRight 分 别 表示 指定 视图 边缘 与 内 容 上 边 、 下 边 、 左边 、 右边 的 距离 。 
e visibility: 指定 该 视图 的 可 视 类 型 。 可 视 类 型 的 取 值 说 明 见 表 2-3。 


表 2-3 可 视 类 型 的 取 值 说 明 











XML 中 的 可 视 类 型 View 类 中 的 可 视 类 型 说 明 

visible VISIBLE 可 见 。 默 认 值 

invisible INVISIBLE 不 可 见 。 虽 然 看 不 到 但 还 占 着 位 置 
gone | GONE | 消失 。 不 仅 看 不 到 而 且 不 占 位 置 了 





下 面 是 视图 在 代码 中 常用 的 设置 方法 说 明 。 

e setLayoutParams: 设置 该 视图 的 布局 参数 。 参 数 对 象 的 构造 函数 可 以 设置 视图 的 宽度 和 
高 度 。 其 中 ，LayoutParams.MATCH_PARENT 表示 与 上 级 视图 一 样 帘 ， 也 可 以 是 
LayoutParams.WRAP_CONTENT， 表 示 与 内 部 内 容 一 样 宽 ; 参数 对 象 的 setMargins 方法 
可 以 设置 该 视图 与 周围 视图 之 间 的 空白 距离 。 

setMinimumWidth: 设置 该 视图 的 最 小 宽度 。 

setMinimumHeight: 设置 该 视图 的 最 小 高 度 。 

setBackgroundColor: 设置 该 视图 的 背景 颜色 。 

setBackgroundDrawable: 设置 该 视图 的 背景 图 片 。 
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e setBackgroundResource: 设置 该 视图 的 背景 资源 id。 
e setPadding: 设置 该 视图 边缘 与 内 部 内 容 之 间 的 空白 距离 。 
e setVisibility: 设置 该 视图 的 可 视 类 型 。 取 值 说 明 见 表 2-3. 


前 面 提 到 margin 和 padding 两 个 概念 ，margin 是 指 当 前 视图 与 周围 视图 的 距离 ，padding 
是 指 当 前 视图 与 内 部 内 容 的 距离 。 这 么 说 可 能 有 些 抽象 ， 所 谓 百 闻 不 如 一 见 ， 说 得 再 多 不 如 亲 
眼看 看 是 怎么 回 事 。 我 们 来 做 一 个 实验 , 看 看 它们 的 显示 效果 有 什么 不 同 。 下 面 是 实验 用 的 布 
局 文件 源 代码 ， 以 背景 色 观 察 每 个 控件 的 区 域 范围 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout_height="300dp" 
android:background="#00aaff" 
android:orientation="vertical" 
android:padding="5dp" > 





<LinearLayout 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:layout margin-"20dp" 
android:background-"ZfITf99" 
android:padding-"60dp" > 


«View 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:background-"£ff0000" /> 
«/LinearLayout^ 
*/LinearLayout^ 


最 后 的 界面 效果 如 图 2-5 所 示 。 布 局 文件 处 于 中 
间 层 的 LinearLayout， 设 置 margin 是 20dp、padding 
是 60dp。 从 效果 图 可 以 看 到 ， 中 间 层 与 上 级 视图 之 间 
的 距离 大 约 是 中 间 层 与 下 级 视图 之 间距 离 的 三 分 之 
-， 正 好 是 margin 和 padding 两 个 数值 的 比例 。 如 此 
便 从 实际 情况 中 印证 了 : layout_margin 指 的 是 当前 图 
层 与 外 部 图 层 的 距离 ， 而 padding 指 的 是 当前 图 层 与 
内 部 图 层 的 距离 。 
视图 组 ViewGroup 是 一 类 特殊 视图 ， 所 有 布局 视 
图 类 都 是 从 它 派生 而 来 的 。Android 中 的 视图 分 为 两 
类 ， 一 类 是 布局 ， 另 一 类 是 控件 。 布 局 与 控件 的 区 别 图 2-5 margin 和 padding 的 演示 画面 
TET: 布局 本 质 上 是 个 容器 ， 里面 还 可 以 放 其 他 视图 (包括 子 布 局 和 子 控件 ) ; 控件 是 一 个 单 


Junior 
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一 的 实体 ， 已 经 是 最 后 一 级 ， 下 面 不 能 再 挂 其 他 视图 。 打 个 比方 ， 我们 把 根 节点 看 作 树干 ， 根 
节点 下 的 各 级 布局 就 是 树枝 ， 一 根 树枝 可 以 连 着 其 他 小 树枝 ， 也 可 以 直接 连 树叶 ; 树叶 只 能 依 
附 在 树枝 上 ， 不 能 再 连 树枝 或 其 他 树叶 。 

ViewGroup 有 3 个 方法 ， 这 3 个 方法 也 是 所 有 布局 类 视图 共同 拥有 的 。 


e addView: 往 布局 中 添加 一 个 视图 。 
e removeView: 从 布局 中 删除 指定 视图 。 
e removeAllViews: 删除 该 布局 下 的 所 有 视图 。 


222 ”线性 布局 LinearLayout 


LinearLayout 是 最 常用 的 布局 ， 名 字 叫 线性 布局 。 顾 名 思 义 ，LinearLayout 下 面 的 子 视图 
就 像 用 一 根 线 串 了 起 来 , 所 以 LinearLayout 内 部 视图 的 排列 是 有 顺序 的 , 要 么 从 上 到 下 依次 垂 
直 排列 ， 要 么 从 左 到 右 依次 水 平 排列 。LinearLayout 除了 继承 View/ViewGroup 类 的 所 有 属性 
和 方法 外 ， 还 有 其 特有 的 XML 属性 ， 说 明 如 下 。 


e orientation: 指定 线性 布局 的 方向 。horizontal 表示 水 平 布局 ，vertical 表示 垂直 布局 。 如 
果 不 指定 该 属性 ， 就 默认 是 horizontal。 这 真是 出 乎 意料 ， 因 为 大 家 感觉 手机 App 理应 从 
上 往 下 垂直 布局 , 所 以 这 里 要 特别 注意 垂直 布局 一 定 要 设置 orientation, 不 然 默 认 的 水 平 
布局 不 符合 多 数 业务 场景 。 

e gravity: 指定 布局 内 部 视图 与 本 线性 布局 的 对 齐 方式 。 取 值 说 明 同 layout gravity. 

e layout weight: 指定 当前 视图 的 宽 或 高 占 上 级 线性 布局 的 权重 。 这 里 要 注意 , layout_weight 
属性 并 非 在 当前 LinearLayout 节点 中 设置 ， 而 是 在 下 级 视图 的 节点 中 设置 。 另外， 如 果 
layout. weight 指定 的 是 当前 视图 在 宽度 上 占 的 权重 , layout. width 就 要 同时 设置 为 0dp; 如 
A layout weight 指定 的 是 当前 视图 在 高 度 上 占 的 权重 , layout. height 就 要 同时 设置 为 0dp。 


下 面 是 LinearLayout 在 代码 中 增加 的 两 个 方法 。 


e setOrientation: 设置 线性 布局 的 方向 。LinearLayout.HORIZONTAL 表示 水 平 布局 ， 
LinearLayout. VERTICAL 表示 垂直 布局 。 
e setGravity: 设置 布局 内 部 视图 与 本 线性 布局 的 对 齐 方式 。 具 体 的 取 值 说 明 见 表 2-2。 


接 下 来 重点 解释 layout. gravity 和 gravity 的 区 别 。 前 面 说 过 ，layout_gravity 指定 该 视图 与 
上 级 视图 的 对 齐 方式 ， 而 gravity 指定 布局 内 部 视图 与 本 布局 的 对 齐 方式 。 为 方便 理解 ， 我 们 
通过 一 个 具体 例子 演示 两 种 属性 的 显示 效果 。 下 面 是 演示 用 的 XML 布局 文件 ， 内 部 指定 了 多 
种 对 齐 方式 ,其 中 左边 视图 的 layout. gravity 是 bottom, gravity 是 left; 右边 视图 的 layout. gravity 
A top. gravity 是 right， 布 局 文件 内 容 如 下 : 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"300dp" 
android:background="#ffffo9" 
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android:orientation="horizontal" 
android:padding="5dp" > 


<LinearLayout 
android:layout width-"Odp" 
android:layout height-"200dp" 
android:layout weight-"1" 
android:layout gravity-"bottom" 
android:gravity-"left" 
android:background-"4ff0000" 
android:layout margin-" l0dp" 
android:padding-" 1 0dp" 
android:orientation-" vertical" 


«View 
android:layout width-"100dp" 
android:layout height-" I00dp" 
android:background-"Z00ffff" /> 
«/LinearLayout^ 


*LinearLayout 
android:layout width-"Odp" 
android:layout height-"200dp" 
android:layout weight-"1" 
android:layout gravity-"top" 
android:gravity-"right" 
android:background="#ff0000" 
android:layout_margin="10dp" 
android:padding-" 1 0dp" 
android:orientation-" vertical" 


«View 
android:layout width-"100dp" 
android:layout height-" l00dp" 
android:background-"£400ffIT" /> 
«/LinearLayout^ 
«/LinearLayout^ 


运行 后 的 界面 效果 如 图 2-6 所 示 。 从 效果 图 可 以 看 到 ， 左 边 视 图 自身 向 下 对 齐 ， 符 合 
layout gravity 的 设置 ， 下 级 视图 靠 左 对 齐 ， 符 合 gravity 的 设置 ; 右边 视图 自身 向 上 对 齐 ， 符 
合 layout_gravity 的 设置 ， 下 级 视图 靠 右 对 齐 ， 符 合 gravity 的 设置 。 








Android Studio f 228; 从 零 基 础 到 App 上 线 








2-6 layout gravity 和 gravity 的 演示 界面 
2.2.3 ”滚动 视图 ScrollView 


手机 屏幕 的 显示 空间 有 限 ， 常 常 需要 上 下 滑动 或 左右 滑动 才能 拉 出 其 余 页 面 内容 ， 可 惜 
Android 的 布局 节点 都 不 支持 自行 滚动 ， 这 时 就 要 借助 ScrollView 滚动 视图 实现 了 。 与 线性 布 
局 类 似 ， 滚 动 视图 也 分 为 垂直 方向 和 水 平方 向 两 类 ， 其 中 得 直 滚动 的 视图 名 是 ScrollView, 7K 
平 滚动 的 视图 名 是 HorizontalScrollView。 这 两 个 滚动 视图 的 使 用 并 不 复杂 ， 主 要 注意 以 下 3 点 : 

CI) 垂直 方向 滚动 时 ，layout_ width 要 设置 为 match_parent，layout_height 要 设置 为 
wrap_content。 

(2) 水 平方 向 滚动 时 ，layout_width 要 设置 为 wrap_content，layout_height 要 设置 为 
match_parent。 

(3 ) 滚 动 视图 节点 下 面 必须 且 只 能 挂 着 一 个 子 布局 节点 , 否则 会 在 运行 时 报错 Caused by: 


java.lang.lllegalStateException: ScrollView can host only one direct child 。 
下 面 是 滚动 视图 Scroll View 和 水 平 滚动 视图 HorizontalScrollView 的 XML 用 法 示例 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match parent" 
android:layout height-"match parent" 
android:orientation-" vertical" 


*HorizontalScroll View 
android:layout width-"wrap content" 
android:layout height-"200dp"— 


«LinearLayout 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:orientation-"horizontal" 


«View 
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android:layout width="400dp" 
android:layout height-"match parent" 
android:background-"ZaaffIf" /> 


«View 
android:layout width-"400dp" 
android:layout height-"match parent" 
android:background-" 4ffff00" /> 
*/LinearLayout^ 
*/HorizontalScroll View 


«ScrollView 
android:layout width-"match parent" 
android:layout height-"wrap content" 


*LinearLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:orientation-" vertical" 


«View 
android:layout width-"match parent" 
android:layout height-"400dp" 
android:background-"400ff00" /> 


<View 
android:layout width-"match parent" 
android:layout height-"400dp" 
android:background-"ffffaa" /> 
</LinearLayout> 
</ScrollView> 
</LinearLayout> 


有 时 ScrollView 的 实际 内 容 不 够 ， 又 想 让 它 充满 屏幕 ， 怎 么 办 呢 ? 如 果 把 layout height 属 
性 赋值 为 match_parent， 那 么 结果 还 是 不 会 充满 ， 正 确 的 做 法 是 再 增加 一 行 fillViewport 的 属 
性 设置 ， 举 例如 下 : 
android:layout height-"match parent" 
android:fill Viewport-"true" 
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23 简单 控件 


本 节 介 绍 Android 几 个 简单 控件 的 用 法 与 注意 点 ， 主 要 包括 文本 视图 TextView 的 跑马 灯 
与 聊天 室 效 果 、 按 钮 Button 的 监听 器 使 用 、 图 像 视图 ImageView 的 拉 伸 效果 与 截图 功能 、 图 
像 按钮 ImageButton 的 适用 场合 等 。 


2.3.1 文本 视图 TextView 
TextView 是 最 基础 的 文本 显示 控件 ， 常 用 的 基本 属性 和 设置 方法 见 表 2-4, 
表 2-4 TextView 的 基本 属性 和 设置 方法 说 明 








XML 中 的 属性 | TextView 类 的 设置 方法 | 说 明 
text: setText 设置 文本 内 容 


NOS VILAM 
Emm BEDA 


textAppearance 设置 文本 风格 ， 风 格 定义 在 res/styles.xml 


gravity 设置 文本 的 对 齐 方式 ， 对 应 的 方法 是 setGravity。 取 值 说 明 见 表 
2-2 


读者 对 于 这 些 基 本 属性 和 方法 想必 并 不 陌生 ， 因 为 在 第 1 章 第 一 个 App“Hello World” 
中 就 用 到 了 它们 ， 这 里 不 再 歼 述 。 接 下 来 介绍 TextView 的 两 个 特效 用 法 。 

1. 跑马 灯 效 果 

当 一 行文 本 的 内 容 太 多 ， 导 致 无 法 全 部 显示 ， 也 不 想 分 行 展 示 时 ， 只 能 让 文字 从 左 向 右 
滚动 显示 , 类似 于 跑马 灯 。 电 视 在 播报 突 发 新 闻 时 经 常 在 屏幕 下 方 轮 播 消息 文字 , 比如 “快讯 : 
我 国 选手 *** 在 刚刚 结束 的 ** 比 赛 中 为 中 国 代表 团 夺 得 第 ** 枚 金牌 ”。 
跑马 灯 效 果 在 XML 布局 文件 中 实现 时 需要 额外 指定 部 分 属性 , 这 些 特 殊 属性 及 其 设置 方 
法 的 详细 说 明 见 表 2-5。 














表 2-5 跑马 灯 用 到 的 属性 与 方法 说 明 




















XML 中 的 属性 跑马 灯 用 到 的 设置 方法 | 说 明 

singleLine setSingleLine 指定 文本 是 否 单行 显示 

ellipsize setEllipsize 指定 文本 超出 范围 后 的 省 略 方式 ， 省 略 方式 的 取 值 说 明 
见 表 2-6 

focusable setFocusable 指定 是 否 获得 焦点 ， 跑 马 灯 效果 要 求 设置 为 tue 

focusableInTouchMode | setFocusableInTouchMode | 指定 在 触摸 时 是 否 获 得 焦点 ,跑马 灯 效 果 要 求 设置 为 true 
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表 2-6 省 略 方式 的 取 值 说 明 














XML 中 的 省 略 方式 TruncateAt 类 中 省 略 方式 说 明 

start START 省 略 号 在 开头 
middle MIDDLE 省 略 号 在 中 间 
end END 省 略 号 在 末尾 
marquee MARQUEE 跑马 灯 显 示 











下 面 是 演示 跑马 灯 效果 的 XML 布局 文件 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-" vertical" 


«TextView 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop-"20dp" 
android:gravity-"center" 


android:text=" 跑 马 灯 效果 ， 点 击 暂 停 ， 再 点 击 恢复 " /> 


<TextView 
android:id="@+id/tv_marquee" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop-"20dp" 
android:singleLine-"true" 
android:ellipsize-"marquee" 
android:focusable-"true" 
android:focusableInTouchMode-"true" 
android:textColor-"4000000" 
android:textSize-"17sp" 
android:text=" 快 讯 : 红色 预警 ， 超 强 台 风 “ 英 兰 蒂 ” 即 将 登陆 ， 请 居民 关 紧 门窗 、 备 足 粮 
草 ， 做 好 防汛 救灾 准备 ! "人 
</LinearLayout> 


跑马 灯 滚 动 的 效果 界面 如 图 2-7 和 图 2-8 所 示 。 左 图 为 跑马 灯 文字 在 滚动 中 ,， 右 图 为 跑马 
灯 文 字 停 止 滚动 。 
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图 2-7 跑马 灯 文 字 滚动 界面 图 2-8 跑马 灯 文字 停止 滚动 界面 
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2. 聊天 室 或 者 文字 直播 间 效 果 


聊天 室 窗口 的 高 度 是 固定 的 ， 新 的 文字 消息 总 是 加 入 窗口 末尾 ， 同 时 窗口 内 部 的 文本 整 
体 向 上 滚动 ， 窗 口 的 大 小 、 位 置 保持 不 变 。 

在 XML 布局 文件 中 实现 聊天 室 时 需要 额外 指定 部 分 属性 , 这 些 特殊 属性 及 其 设置 方法 的 
详细 说 明 见 表 2-7。 





表 12-7 聊天 室 用 到 的 属性 与 方法 说 阴 




















XML 中 的 属性 | 聊天 室 用 到 的 设置 方法 | 说 明 

gravity setGravity 指定 文本 的 对 齐 方式 ， 取 值 leftlbottom， 表 示 靠 左 对 齐 且 靠 下 对 齐 

lines setLines 指定 文本 的 行 数 

maxLines setMaxLines 指定 文本 的 最 大 行 数 

scrollbars 无 指定 滚动 条 的 方向 ， 取 值 vertical， 如 果 不 指 定 将 不 显示 滚动 条 

X setMovementMethod 设置 文本 的 移动 方式 ， 可 设置 ScrollingMovementMethod， 如 果 不 
设置 将 无 法 拉动 文本 


接 下 来 看 一 个 简单 聊天 室 的 例子 ， 点 击 聊天 室 窗 口 可 以 添加 一 条 聊天 记录 ， 长 按 聊 天 窗 

口 可 以 清除 所 有 聊天 记录 。 聊 天 室 的 演示 界面 如 图 2-9 和 图 2-10 所 示 ， 图 2-10 ER 2-9 多 添 
加 了 3 条 聊天 记录 ， 整 个 聊天 记录 的 文字 自动 往 上 滚动 。 
Junior 


3:10:11 你 吃饭 了 吗 ? 31017 我 中 奖 啦 ! 
3:10:14 我 中 奖 啦 ! 3:10:19 今天 天 气 真 好 呀 。 


3:10:16 我 们 去 看 电影 吧 3:10:21 你 吃饭 了 吗 ? 
我 中 奖 啦 ! 


3:10:17 ! 3:10:24 我 们 去 看 电影 吧 
31019 今天 天 气 真 好 呀 。 3:10:27 晚上 干什么 好 呢 ? 
3:10:21 你 吃饭 了 吗 ? 3:11:28 晚上 干什么 好 呢 ? 
3:10:24 我 们 去 看 电影 吧 3:11:31 晚上 干什么 好 呢 ? 
3:10:27 晚上 干什么 好 呢 ? 3:11:34 我 们 去 看 电影 吧 





图 2-9 初始 的 聊天 室 界面 图 2-10 增加 了 3 条 聊天 记录 
下面 是 聊天 室 例子 用 到 的 XML 布局 文件 内 容 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout width-"match parent" 

android:layout height-"match parent" 

android:orientation-" vertical" 





«TextView 
android:id-"(g)*id/tv control" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginTop-"20dp" 
android:gravity-"center" 
android:text=" 聊 天 室 效果 ， 点 击 添加 聊天 记录 ， 长 按 删除 聊天 记录 " /> 
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<LinearLayout 
android:layout width-"match parent" 
android:layout height-"200dp" 
android:orientation-" vertical" 


«TextView 

android:id—"(a)*id/tv bbs" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:layout marginTop-"20dp" 
android:scrollbars-" vertical" 
android:textColor-"5000000" 
android:textSize-"17sp" /> 

</LinearLayout> 

</LinearLayout> 


下 面 是 聊天 室 例子 用 到 的 代码 示例 : 


public class BbsActivity extends AppCompatActivity implements OnClickListener, OnLongClickListener í 
private TextView tv bbs; 
private TextView tv control; 


(@Override 
protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity bbs); 
tv control = (TextView) findViewById(R.id.tv control); 
tv control.setOnClickListener(this); 
tv control.setOnLongClickListener(this); 
tv bbs = (TextView) findViewById(R.id.tv bbs); 
tv bbs.setOnClickListener(this); 
tv. bbs.setOnLongClickListener(this); 
tv. bbs.setGravity(Gravity.LEFT|Gravity.BOTTOM); 
tv. bbs.setLines(8); 
tv bbs.setMaxL ines(8); 
tv. bbs.setMovementMethod(new ScrollingMovementMethod()); 
b 


private String[] mChatStr = ( "你 吃饭 了 吗 ? ", "今天 天 气 真 好 蚜 。", 

"我 中 奖 啦 ! " "我 们 去 看 电影 吧 " "晚上 干什么 好 呢 ? "y; 
@Override 
public void onClick(View v) { 

if (v.getId() = R.id.tv control || v.getld() = R.id.tv_bbs) í 
int random = (int)(Math.random()*10) % 5; 
String newStr = String. format("%s\n%s %s", 
tv_bbs.getText().toString(), DateUtil.getNowTime(), mChatStr[random]); 
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tv bbs.setText(newStr); 


1: 
@Override 
public boolean onLongClick(View v) { 
if (v.getId() = R.id.tv control || v.getld() = R.id.tv bbs) í 
tv. bbs.setText(""); 
n 


return true; 


} 
23.2 ”按钮 Button 


Button 派生 自 TextView， 二 者 在 UI 上 的 区 别 主 要 是 Button 控件 有 个 按钮 外 观 ， 提 示 用 
户 点 击 这 里 。 系 统 默认 的 按钮 外 观 通常 都 不 好 看 ， 需 要 更 换 靓 一 点 、 活 泌 一 点 的 图 片 ， 这 时 在 
布局 文件 中 修改 Button 节点 的 background 属性 就 可 以 了 。 如 果 把 background 属性 设置 为 @null， 
就 会 去 除 Button 控件 的 背景 样式 ， 此 时 的 Button 看 起 来 跟 TextView 没什么 区 别 。 

前 面 在 演示 聊天 室 功能 时 ， 我 们 为 TextView 引入 了 点 击 方法 和 长 按 方法 。 因 为 点 击 和 长 
按 监 听 器 都 来 源 于 View X, 所 以 这 两 个 方法 及 其 监听 器 并 非 Button 特有 的 , 而 是 所 有 布局 和 
控件 都 能 使 用 的 ， 一 般 用 于 为 按钮 控件 注册 点 击 和 长 按 事件 。 

Android 中 的 简单 按钮 主要 是 Button 和 后 面 提 到 的 ImageButton。 这 两 个 按钮 对 点 击 和 长 
按 监听 器 的 使 用 方法 并 不 复杂 ， 主 要 步骤 如 下 : 

ED 自己 定义 一 个 扩展 自 监听 器 的 类 ， 如 点 击 监听 器 扩展 自 View.OnClickListener， 长 按 监 
听 器 扩展 自 View.OnLongClickListener, 为 了 方便 起 见 , 也 可 以 直接 给 页 面 的 Activity 类 加 上 监听 器 接口 。 

EI 在 自 定义 监听 器 类 中 重 写 点 击 或 者 长 按 方法 , 加 入 事件 处 理 的 代码 。 点 击 方法 的 名 称 是 
onClick， 长 按 方法 的 名 称 是 onLongClick。 

E 哪个 视图 要 响应 点 击 或 长 按 , 就 给 哪个 视图 注册 对 应 的 监听 器 对 象 。 点 击 事件 的 注册 方 
法 是 setOnClickListener， 长 按 事 件 的 注册 方法 是 setOnLongClickListener。 


下 面 是 给 Button 对 象 注册 点 击 监听 器 和 长 按 监听 器 的 代码 : 


public class ClickActivity extends AppCompatActivity í 

(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity click); 
Button btn click = (Button) find ViewByld(R.id.btn click); 
btn click.setOnClickListener(new MyOnClickListener()); 
btn click.setOnLongClickListener(new MyOnLongcC lickListener()); 





























} 
class MyOnClickListener implements View.OnClickListener { 
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@Override 
public void onClick(View v) { 
if (v.getld() = R.id.btn click) í 
Toast.makeText(ClickActivity.this, "您 点 击 了 控件 : "+ ((TextView) v).getText(), 
Toast.LENGTH SHORT).show(); 
} 
$ 
b 
class MyOnLongClickListener implements View.OnLongClickListener í 
(@Override 
public boolean onLongClick(View v) í 
if (v.getld() = R.id.btn_click) í 
Toast.makeText(ClickActivity.this, "您 长 按 了 控件 : "+ ((TextView) v).getText(), 
Toast.LENGTH_SHORT).show(); 
$ 


return true; 


fi 
2.3.8 图 像 视图 ImageView 
ImageView 是 图 像 显示 控件 ， 与 图 形 显 示 有 关 的 属性 说 明 如 下 。 
e scaleType: 指定 图 形 的 拉 伸 类 型 ， 默 认 是 fitCenter。 拉 伸 类 型 的 取 值 说 明 见 表 2-8。 


e src: 指定 图 形 来 源 ，src 图 形 按照 scaleType 拉 伸 。 注 意 背 景 图 不 按 scaleType 指定 的 方 
式 拉 伸 ， 背 景 默 认 以 fitXY 方式 拉 伸 。 


表 2-8 拉 伸 类 型 的 取 值 说 明 
































XML 中 的 拉 伸 类 型 | ScaleType 类 中 的 拉 伸 类 型 | 说 明 

fitXY FIT XY 拉 伸 图 片 使 其 正好 填 满 视图 〈 图 片 可 能 被 拉 伸 变形 ) 

fitStart FIT_START 拉 伸 图 片 使 其 位 于 视图 上 部 

fitCenter FIT CENTER 拉 伸 图 片 使 其 位 于 视图 中 间 

fitEnd FIT END 拉 伸 图 片 使 其 位 于 视图 下 部 

center CENTER 保持 图 片 原 尺寸 ， 并 使 其 位 于 视图 中 间 

centerCrop CENTER CROP 拉 伸 图 片 使 其 充满 视图 ， 并 位 于 视图 中 间 

centerInside CENTER INSIDE 使 图 片 位 于 视图 中 间 《〈 只 压 不 拉 )。 当 图 片 尺 寸 大 于 视图 
时 , centerInside 等 同 于 fitCenter; 当 图 片 尺寸 小 于 视图 时 ， 
centerInside 等 同 于 center 








ImageView 在 代码 中 调用 的 方法 说 明 如 下 。 


e setScaleType: 设置 图 形 的 拉 伸 类 型 。 具 体 的 取 值 说 明 见 表 2-8。 
e setlmageDrawable: 设置 图 形 的 Drawable 对 象 。 
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e setlmageResource: 设置 图 形 的 资源 ID. 
e setImageBitmap: 设置 图 形 的 位 图 对 和 象 。 


读者 应 该 注意 到 ImageView 的 拉 伸 类 型 种 类 繁多 、 文 字 说 明 不 易 理 解 ， 特 别 是 center 相 
关 的 类 型 就 有 4 种 : fitCenter、center、centerCrop、centerInside。 接 下 来 进行 一 个 实验 ， 把 一 
张 图 片 放 入 ImageView 控件 ， 尝 试 使 用 不 同 的 拉 伸 类 型 ， 看 看 效果 有 什么 区 别 。 下 面 是 图 片 
拉 伸 演示 用 的 代码 示例 : 


public class ScaleActivity extends AppCompatActivity implements OnClickListener í 
private ImageView iv scale; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity scale); 
iv scale = (ImageView) find ViewById(R.id.iv scale); 
findViewByld(R.id.btn center).setOnClickListener(this); 
findViewBylId(R.id.btn fitCenter).setOnClickListener(this ); 
findViewById(R.id.btn centerCrop).setOnClickListener(this); 
findViewById(R.id.btn centerInside).setOnClickListener(this); 
findViewByld(R.id.btn fitXY).setOnClickListener(this); 
findViewById(R.id.btn fitStart).setOnClickListener(this); 
findViewById(R.id.btn fitEnd).setOnClickListener(this); 

j 


(@Override 
public void onClick(View v) í 
if (v.getld() — R.id.btn center) í 
iv scale.setScaleType(ImageView.ScaleType.CENTER); 
) else if (v.getId() = R.id.btn fitCenter) í 
iv scale.setScaleType(ImageView.ScaleType.FIT CENTER); 
} else if (v.getId() = R.id.btn centerCrop) í 
iv. scale.setScaleType(Image View.ScaleType. CENTER. CROP); 
} else if (v.getId() = R.id.btn centerInside) í 
iv. scale.setScaleType(Image View.ScaleType.CENTER. INSIDE); 
} else if (v.getld() = R.id.btn fitXY) { 
iv scale.setScaleType(ImageView.ScaleType.FIT XY); 
) else if (v.getld() = R.id.btn fitStart) í 
iv scale.setScaleType(ImageView.ScaleType.FIT START); 
} else if (v.getId() = R.id.btn fitEnd) { 
iv scale.setScaleType(ImageView.ScaleType.FIT END); 
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至 于 图 像 拉 伸 的 演示 界面 ，fitCenter 的 效果 如 图 2-11 所 示 ， 图 片 被 拉 伸 但 未 超出 控件 范 


Hi]; center 的 效果 如 图 2-12 


所 示 ， 图 片 没有 拉 伸 ;centerCrop 的 效果 如 图 2-13 所 示 ， 图 片 被 


拉 伸 且 已 超出 控件 范围 ; centerInside 的 效果 如 图 2-14 所 示 ， 图 片 没有 被 拉 伸 。 














° 


图 2-11 fitCenter 的 效果 图 图 2-12 center 的 效果 图 


° 








图 2-13 centerCrop 的 效果 图 图 2-14 centerlnside 的 效果 图 


Android 能 用 ImageView 展示 图 片 , 也 自 带 屏幕 截图 功能 。 尽管 自 带 的 屏蔽 截图 功能 有 些 
简单 ,不 过 多 数 场合 已 经 够 用 了 。 截图 功能 面向 所 有 视图 , 我 们 可 以 从 其 他 控件 或 布局 那里 截 
图 下 来 ， 然 后 显示 在 ImageView 上 面 。 

使 用 截图 功能 必须 通过 代码 完成 ， 相 关 方 法 如 下 这 些 方法 都 来 自 于 View 类 ) 。 


供 该 方法 ， 因 为 绘图 
果 就 是 黑 乎 一片 








setDrawingCacheEnabled: 设置 绘图 缓存 的 可 用 状态 。true 表示 打开 ，false 表示 关闭 。 
isDrawingCacheEnabled: 判断 该 控件 的 绘图 缓存 是 否 可 用 。 

setDrawingCacheQuality: 设置 绘图 缓存 的 质量 。 

getDrawingCache: 获取 该 控件 的 绘图 缓存 结果 ， 返 回 值 为 Bitmap 类 型 。 
setDrawingCacheBackgroundColor: 设置 绘图 缓存 的 背景 颜色 。 大 家 可 能 会 奇怪 为 何 要 提 















































缓存 默认 背景 色 是 黑色 ,如果 不 提 前 设置 缓存 的 背景 色 ， 截 图 的 结 
所 以 需要 将 背景 色 设置 为 默认 颜色 (通常 是 白色 ) 。 
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操作 截图 功能 的 具体 步骤 如 下 : 

CXXoi 开始 截图 前 ， 先 调用 setDrawingCacheEnabled 方法 ， 设 置 绘图 缓存 为 可 用 状态 。 注 意 该 
方法 在 一 开始 就 得 调用 ， 因 为 先 开启 绘图 缓存 ， 之 后 变更 的 界面 才 会 记录 到 缓存 中 ; 如 果 先 变更 界面 
再 开启 绘图 缓存 ， 缓 存 里 就 是 空 的 。 

€ 调用 getDrawingCache 方法 获取 缓存 中 的 图 像 数据 。 

ED 完成 截图 ， 延迟 若干 毫秒 后 调用 setDrawingCacheEnabled 方法 关闭 绘图 缓存 。 如 果 接 下 
来 还 要 截图 ， 就 再 次 调用 setDrawingCacheEnabled 方法 重新 开启 绘图 缓存 。 


下 面 是 完成 截图 功能 的 代码 : 


public class CaptureActivity extends AppCompatActivity implements OnClickListener, OnLongClickListener { 
private TextView tv_capture; 




































































































































































private ImageView iv_capture; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity capture); 
tv capture = (TextView) find ViewById(R.id.tv capture); 
iv capture = (Image View) find ViewById(R.id.iv capture); 
tv capture.setDrawingCacheEnabled(true); 
findViewByld(R.id.btn chat).setOnClickListener(this); 
findViewByld(R.id.btn chat).setOnLongClickListener(this); 
findViewById(R.id.btn capture).setOnClickListener(this); 

j 


private String[] mChatStr = {" 你 吃饭 了 吗 ?", "今天 天 气 真 好 蚜 。", 
"我 中 奖 啦 ! " "我 们 去 看 电影 吧 。", "晚上 干什么 好 昵 ?" }; 
@Override 
public boolean onLongClick(View v) { 
if (v.getld() = R.id.btn chat) í 
tv_capture.setText(""); 


j 

return true; 
$ 
@Override 


public void onClick(View v) { 
if (v.getld() = R.id.btn chat) í 
int random = (int)(Math.random()*10) % 5; 
String newStr = String.format("%sVn%s "os", 
tv capture.getText().toString(), DateUtil.getNowTime(), mChatStr[random]); 
tv capture.setText(newStr); 
1 else if (v.getld() — R.id.btn. capture) { 
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Bitmap bitmap = tv_capture.getDrawingCache(); 
iv_capture.setImageBitmap(bitmap); 

// 注意 截图 完毕 后 不 能 马上 关闭 绘图 缓存 ， 因 为 界面 泻 染 需要 时 间 
/ 如 果 立 即 关 闭 缓存 ， 泻 染 界面 就 会 找 不 到 位 图 对 象 ， 从 而 报错 
// java.lang.IllegalArgumentException: Cannot draw recycled bitmaps 
mHandler.postDelayed(mResetCache, 200); 


1 


private Handler mHandler = new Handler(); 
private Runnable mResetCache = new Runnable() í 
@Override 
public void run() { 
tv_capture.setDrawingCacheEnabled(false); 
tv capture.setDrawingCacheEnabled(true); 


; 


对 应 的 截图 演示 界面 如 图 2-15 和 图 2-16 所 示 。 其 中 ， 图 2-15 所 示 为 截图 前 的 界面 ， 图 
2-16 所 示 为 截图 后 的 界面 。 





3:15:08 我 们 去 看 电影 吧 。 3:15:08 我 们 去 看 电影 吧 。 13:15:08 我 们 去 看 电影 吧 。 
3:15:09 晚上 干什么 好 呢 ? 3:15:09 晚上 干什么 好 呢 ? 13:15:09 晚上 干什么 好 呢 ? 
3:15:11 晚上 干什么 好 呢 了 3:15:11 晚上 干什么 好 呢 ? 13:15:11 晚上 干什么 好 呢 ? 
3:15:49 我 们 去 看 电影 吧 。 13:15:49 我 们 去 看 电影 吧 。 
3:15:50 你 吃饭 了 吗 ? 13:15:50 你 吃饭 了 吗 ? 


聊天 Li] 聊天 m 











图 2-15 “截图 前 只 有 左边 有 文字 图 2.16 截图 后 在 右边 显示 图 片 
234 图 像 按钮 ImageButton 


ImageButton 其 实 派 生 自 ImageView， 而 不 是 派生 自 Button, ImageView 拥有 的 属性 和 方 
法 ，ImageButton 统统 拥有 ， 只 是 ImageButton 有 个 默认 的 按钮 外 观 。 

ImageButton 和 Button 都 起 到 控制 按钮 的 作用 , 不 同 的 是 Button 是 文本 按钮 , ImageButton 
是 图 像 按钮 ， 这 两 个 按钮 的 主要 区 别 在 于 : 


(1) Button 既 可 显示 文本 也 可 显示 图 形 (通过 设置 背景 图 ) ， 而 ImageButton 只 能 显示 
图 形 不 能 显示 文本 。 


| 
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(2) ImageButton 上 的 图 像 可 按 比 例 拉 伸 ， 而 Button 上 的 大 图 会 拉 伸 变形 〈 因 为 背景 图 
无 法 按 比 例 拉 伸 ) 。 

(3) Button 只 能 在 背景 显示 一 张 图 形 ， 而 ImageButton 可 分 别 在 前 景 和 背景 显示 两 张 图 
形 ， 实 现 图 片 琶 加 的 效果 。 

从 上 面 可 以 看 出 ，Button 与 ImageButton 各 有 千秋 ,通常 情况 下 使 用 Button 就 够 用 了 。 但 
在 某 些 场合 ， 比 如 输入 法 打 不 出 来 的 字符 和 以 特殊 字体 显示 的 字符 串 ， 就 适合 先 切 图 再 用 
ImageButton 显示 。 

现在 我 们 有 了 Button 可 在 按钮 上 显示 文字 , 又 有 ImageButton 可 在 按钮 上 显示 图 形 , 照 理 
说 绝 大 多 数 场合 都 够 用 了 。 可 是 现实 项 目 中 的 需求 往往 十 分 怪异 , 例如 客户 要 求 在 按钮 文字 的 
左边 加 一 个 图 标 , 这 样 按钮 内 部 既 有 文字 又 有 图 片 , 乍 看 之 下 Button 和 ImageButton 都 没 法 直 
接 使 用 。 若 把 图 标 和 文字 放 在 一 起 切 图 , 每 次 图 标 与 文字 的 大 小 或 距离 发 生变 化 时 岂 不 是 都 要 
重新 切 图 ? 若 用 LinearLayout 对 ImageView 和 TextView 组 合 布局 ， 这 样 固然 可 行 ， 但 是 布局 
文件 会 兄长 许多 。 

其 实 有 个 既 简单 又 灵活 的 办 法 ， 要 想 在 文字 周围 放置 图 片 ， 使 用 TextView 就 能 实现 ， 那 
么 基于 TextView 的 Button 自然 能 实现 。 具 体 可 在 XML 布局 文件 中 设置 以 下 5 个 属性 。 
drawableTop: 指定 文本 上 方 的 图 形 。 
drawableBottom: 指定 文本 下 方 的 图 形 。 
drawableLeft: 指定 文本 左边 的 图 形 。 
drawableRight: 指定 文本 右边 的 图 形 。 
drawablePadding: 指定 图 形 与 文本 的 间距 。 


若 在 代码 中 实现 ， 则 可 调用 如 下 方法 。 

e setCompoundDrawables: 设置 文本 周围 的 图 形 。 可 分 别 设 置 左边 、 上 边 、 右 边 、 下 边 的 
图 形 。 

e setCompoundDrawablePadding: 设置 图 形 与 文本 的 间距 。 

下 面 的 代码 演示 在 按钮 中 变换 图 标 位 置 的 功能 : 


public class IconActivity extends AppCompatActivity implements OnClickListener í 
private Button btn icon; 
private Drawable drawable; 








@Override 
protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_icon); 
btn icon = (Button) findViewById(R.id.btn_icon); 
drawable = getResources().getDrawable(R.mipmap.ic_launcher); 
/ 必须 设置 图 片 大 小 ， 否 则 不 显示 图 片 
drawable.setBounds(0, 0, drawable.getMinimumWidth(), drawable.getMinimumHeight()); 
findViewByld(R.id.btn left).setOnClickListener(this); 
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findViewByld(R.id.btn top).setOnClickListener(this); 

findViewById(R.id.btn right).setOnClickListener(this); 

findViewByld(R.id.btn bottom).setOnClickListener(this); 
h 


@Override 
public void onClick(View v) { 
if (v.getld() — R.id.btn left) { 
btn icon.setCompoundDrawables(drawable, null, null, null); 
} else if (v.getld() = R.id.btn top) í 
btn icon.setCompoundDrawables(null, drawable, null, null); 
} else if (v.getId() = R.id.btn right) { 
btn icon.setCompoundDrawables(null, null, drawable, null); 
} else if (v.getId() = R.id.btn bottom) { 
btn icon.setCompoundDrawables(null, null, null, drawable); 
) 


j 


变换 图 标 位 置 的 效果 界面 如 图 2-17 (图 标 在 文字 左边 ) EQ 2-18 (图 标 在 文字 右边 〉、 
图 2-19 (图标 在 文字 上 边 ) 、 图 2-20〈 图 标 在 文字 下 边 ) 所 示 。 


Junior Junior 


D mnm 热烈 欢迎 六 2 


图 标 在 左 图 标 在 上 图 标 在 右 图 标 在 下 图 标 在 左 图 标 在 上 图 标 在 右 图 标 在 下 





图 2-17 图标 在 文字 左边 图 2-18 图 标 在 文字 右边 








n 热烈 欢迎 
= I 
热烈 欢迎 = 
图 标 在 左 图 标 在 上 图 标 在 右 图 标 在 下 图 标 在 左 图 标 在 上 图 标 在 右 图 标 在 下 
图 2-19 图 标 在 文字 上 边 220 图 标 在 文字 下 边 


2.4 图形 基 础 
本 节 介 绍 Android 图 形 的 基本 概念 和 几 种 常见 图 形 的 使 用 方法 ， 主 要 包括 状态 列表 图 形 
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StateListDrawable 的 定义 与 使 用 、 形 状 图 形 ShapeDawable 的 定义 与 使 用 、 九 宫 格 图 片 ( 点 九 
图 片 ) 的 制作 与 适用 场景 等 。 


24.1 图 形 Drawable 


Android 把 所 有 显示 出 来 的 图 形 都 抽象 为 Drawable (可 绘制 的 ) 。 这 里 的 图 形 不 止 是 图 片 ， 
还 包括 色 块 、 画 板 、 背 景 等 。 
drawable 文件 放 在 res 目录 的 各 个 drawable 目录 下 。\res\drawable 一 般 存放 的 是 描述 性 的 
XML 文件 ， 图 片 文件 一 般 放 在 具体 分 辨 率 的 drawable 目录 下 。 例 如 : 
e drawable-ldpi 里 面 存放 低 分 辩 率 的 图 片 (如 240 x 320) ， 现 在 基本 没有 这 样 的 智能 手 
机 了 。 
e drawable-mdpi 里 面 存放 中 等 分 辨 率 的 图 片 (如 320 x 480), 这 样 的 智能 手机 已 经 很 少 了 。 
e drawable-hdpi 里 面 存放 高 分 辩 率 的 图 片 (如 480 x 800 ) ， 一 般 对 应 4 寸 ~4.5 寸 的 手机 
(但 不 绝对 ， 同 尺寸 的 手机 有 可 能 分 辩 率 不 同 ， 手 机 分 状 率 就 高 不 就 低 ， 因 为 分 辨 率 低 





了 屏幕 会 有 模糊 的 感觉 ) 。 

e drawable-xhdpi 里 面 存放 加 高 分 辩 率 的 图 片 (如 720 x 1280) ， 一 般 对 应 5 + -5.5 寸 的 
手机 。 

e drawable-xxhdpi 里 面 存 放 超 高 分 辩 率 的 图 片 (如 1080 x 19200 ， 一 般 对 应 6 寸 ~ 6.5 + 
的 手机 。 

e drawable-xxxhdpi 里 面 存 放 超 超 高 分 辩 率 的 图 片 (如 1440 x2560) ， 一 般 对 应 7 TAE 
的 平板 电脑 。 


基本 上 ， 分 辨 率 每 加 大 一 级 ， 宽 度 和 高 度 就 要 加 大 二 分 之 一 或 三 分 之 一 像素 。 如 果 各 目 
录 存 在 同名 图 片 ，Android 就 会 根据 手机 的 分 辨 率 分 别 适 配 对 应 文件 夹 里 的 图 片 。 在 开发 App 
时 , 为 了 兼容 不 同 的 手机 屏幕 , 根据 需求 在 各 目录 存放 不 同 分 辨 率 的 图 片 才 能 达到 最 合适 的 显 
示 效 果 。 例 如 ， 在 drawable-hdpi 放 了 一 张 背景 图 片 bg.png( 分 辨 率 480X800) ， 其 他 目录 没 
放 ， 使 用 分 辨 率 480X 800 的 手机 查看 该 App 没有 问题 , 但 是 使 用 分 辩 率 720 x 1280 的 手机 查 
看 App 会 发 现 背 景 图 片 有 点 模糊 , 原因 是 Android 为 了 让 bg.png 适 配 高 分 辨 率 的 屏幕 ,把 bg.png 
拉 伸 到 了 720X1280， 拉 伸 的 后 果 是 图 片 变 得 模糊 。 

开发 者 拿 到 一 张 图 片 ， 可 以 直接 复制 粘贴 到 drawable 目录 ， 也 可 以 通过 批量 drawable {ifi 
件 Android Postfix Completion 生成 并 导入 各 分 辨 率 的 图 片 ， 该 插件 的 安装 和 使 用 方法 参见 第 1 
章 的 “1.5.3 安装 常用 插件 ”。 

在 XML 布局 文件 中 引用 drawable 文件 可 使 用 “@drawable/***” 这 种 形式 , 如 background 
属性 、ImageView 和 ImageButton 的 src 属性 、TextView 和 Button 的 drawableTop 系列 属性 都 
可 以 引用 drawable 文件 。 

在 代码 中 引用 drawable 文件 可 分 为 两 种 情况 : 


(1) 使 用 setBackgroundResource 和 setImageResource 方法 , 可 直接 在 参数 中 指定 drawable 
文件 的 资源 ID， 例 如 “R.drawable.***”。 
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(2) 使 用 setBackgroundDrawable、setImageDrawable 和 setCompoundDrawables 等 方法 ， 
参数 是 Drawable 对 象 ， 这 时 得 先 从 资源 文件 中 生成 Drawable 对 象 ， 示 例 代 码 如 下 : 


Drawable drawable = getResources().getDrawable(R.drawable.apple); 
24.2 ”状态 列表 图 形 


一 般 drawable 是 静态 图 形 ， 如 Button 按钮 的 背景 在 正常 情况 下 是 凸 起 的 ， 在 按 下 时 是 凹 
陷 的 ， 从 按 下 到 弹 起 的 过 程 , 用 户 便 能 知道 点 击 了 这 个 按钮 。 根 据 不 同 的 触摸 情况 变更 图 形 显 
示 , 这 种 情况 会 用 到 Drawable 的 一 个 子 类 StateListDrawable， 该 子 类 在 XML 文件 中 定义 不 同 
状态 时 呈现 图 形 列表 。 

下 面 是 一 个 状态 列表 图 形 的 drawable 文件 : 

<selector xmlns:android="http://schemas.android.com/apk/res/android"> 

<item android:state pressed-"true" android:drawable="(@drawable/button_pressed" /> 
<item android:drawable="(@drawable/button_normal" /> 

</selector> 





该 XML 定义 文件 中 的 关键 点 是 state_pressed， 值 为 true 表示 按 下 时 显示 button_pressed 
图 像 ， 其 余 情况 显示 button_normal 图 像 。 

为 方便 理解 ， 接 下 来 我 们 先 将 Button 控件 的 background 属性 设置 为 该 drawable 文件 ， 然 
后 在 屏幕 上 点 击 这 个 按钮 , 看 看 按 下 和 弹 起 时 分 别 呈 现 什 么 效果 , 界面 如 图 2-21 ( 按 下 按钮 )、 
图 2-22 按 钮 弹 起 ) 所 示 。 
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默认 样式 的 按钮 默认 样式 的 按钮 


定制 样式 的 按钮 





图 2-21 按 下 按钮 时 的 背景 样式 图 2-22 按钮 弹 起 时 的 背景 样式 


StateListDrawable 不 仅 用 于 Button 控件 , 而 且 可 以 用 于 其 他 拥有 不 同 状 态 的 控件 , 取决 于 
开发 者 对 StateListDrawable 状态 类 型 的 定义 。 状 态 类 型 的 取 值 说 明 见 表 2-9。 


表 2-9 状态 类 型 的 取 值 说 明 








状态 类 型 常用 的 控件 














state pressed 按钮 Button 
state checked | 是 否 勾 选 单 选 框 RadioButton、 复 选 框 CheckBox 
state focused | 是 否 获取 焦点 文本 编辑 框 EditText 





state selected 各 控件 均 可 
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2.4.3 ”形状 图 形 


前 面 讲 到 可 在 XML 文件 中 描述 状态 列表 图 形 的 定义 ， 还 有 一 种 常用 的 XML 图 形 文 件 ， 
是 描述 形状 定义 的 图 形 shape 图 形 。 用 好 shape 可 以 让 App 页 面 不 再 呆板 , 还 可 以 节省 美 
工 不 少 工作 量 。 

形状 图 形 的 定义 文件 以 shape 元 素 为 根 节点 。 根 节点 下 定义 了 6 个 节点 : corners ( 圆 角 ) ~ 
gradien (渐变 ) 、padding (间隔 ) ~ size (RSF) ~ solid (填充 ) ~ stroke 〈 描 边 ) ， 各 节点 
的 属性 值 主要 是 长 宽 、 半 径 、 角 度 以 及 颜色 。 下 面 是 形状 图 形 各 个 节点 和 属性 的 简要 说 明 。 








1. shape 


shape 是 XML 文件 的 根 节点 ， 用 来 描述 该 形状 图 形 是 哪 种 几何 图 形 。 下 面 是 shape 节点 
的 常用 属性 说 明 。 


e shape: 字符 串 类 型 ， 图 形 的 形状 。 形 状 类 型 的 取 值 说 明 见 表 2-10。 
表 2-10 形状 类 型 的 取 值 说 明 








形状 类 型 说 明 
rectangle 和 矩形。 默认 值 
oval | 椭圆 。 此 时 corners 节点 会 失效 








直线 。 此 时 必须 设置 stroke 节点 ， 不 然 会 报错 






line 


2. corners 


corners 是 shape 的 下 级 节点 ， 用 来 描述 4 个 圆 角 的 规格 定义 。 若 无 corners 节点 ， 则 表示 
没有 圆 角 。 下 面 是 corners 节点 的 常用 属性 说 明 。 


bottomLeftRadius: 像素 类 型 ， 左 下 圆 角 的 半径 。 

bottomRightRadius: 像素 类 型 ， 右 下 圆 角 的 半径 。 

topLeftRadius: 像素 类 型 ， 左 上 圆 角 的 半径 。 

topRightRadius: 像素 类 型 ， 右 上 圆 角 的 半径 。 

radius: 像素 类 型 ， 圆 角 半 径 ( 若 有 上 面 4 个 圆 角 半径 的 定义 ， 则 不 需要 radius 定义 ) 。 


3. gradient 
gradient 是 shape 的 下 级 节点 ， 用 来 描述 形状 内 部 的 颜色 渐变 定义 。 若 无 gradient 节点 ， 
则 表示 没有 渐变 效果 。 下 面 是 gradient 节点 的 常用 属性 说 明 。 
e angle: 整 型 ， 渐 变 的 起 始 角度 。 为 0 时 表示 时 钟 的 9 点 位 置 ， 值 增 大 表示 往 逆 时 针 方 向 
旋转 。 例 如 ， 值 为 90 表示 6 点 位 置 ， 值 为 180 表示 3 点 位 置 ， 值 为 270 表示 0 点 /12 点 
位 置 。 
e typ: 字符 串 类 型 ， 渐 变 类 型 。 渐 变 类 型 的 取 值 说 明 见 表 2-11. 
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表 2-11 渐变 类 型 的 取 值 说 明 








渐变 类 型 说 明 
linear 线性 渐变 ， 默 认 值 
radial | 放射 浙 变 ， 起 始 颜色 就 是 圆心 颜色 





Sweep 滚动 渐变 ， 即 一 个 线段 以 某 个 端点 为 圆心 做 360 度 旋 转 





A 


centerX: 浮 点 型 ， 圆 心 的 X 坐标 。 当 android:type="linear" 时 不 可 用 。 

centerY: 浮 点 型 ， 圆 心 的 Y 坐标 。 当 android:type="linear" 时 不 可 用 。 
gradientRadius: 整 型 ， 渐 变 的 半径 。 当 android:type="radial" 时 才 需 要 设置 该 属性 。 
centerColor: 颜色 类 型 ， 渐 变 的 中 间 颜 色 。 

startColor: 颜色 类 型 ， 渐 变 的 起 始 颜色 。 

endColor: 颜色 类 型 ， 渐 变 的 终止 颜色 。 

useLevel: 布尔 类 型 ， 设 置 为 tue 无 渐变 色 、false 有 渐变 色 。 


. padding 


padding 是 shape 的 下 级 节点 ， 用 来 描述 形状 图 形 与 周围 视图 的 间隔 大 小 。 若 无 padding 


节点 ， 


5 


Si 


则 表示 四 周 不 设 间 隔 。 下 面 是 padding 节点 的 常用 属性 说 明 。 
bottom: 像素 类 型 ， 与 下 边 的 间隔 。 

left: 像素 类 型 ， 与 左边 的 间隔 。 

right: 像素 类 型 ， 与 右边 的 间隔 。 

top: 像素 类 型 ， 与 上 边 的 间隔 。 


. Size 


ze 是 shape 的 下 级 节点 ， 用 来 描述 形状 图 形 的 尺寸 大 小 〈 宽 度 和 高 度 ) o FJ size 节点 ， 


则 表示 宽 高 自 适应 。 下 面 是 size 节点 的 常用 属性 说 明 。 


6 


height: 像素 类 型 ， 图 形 高 度 。 
width: 像素 类 型 ， 图 形 宽度 。 


. Solid 


solid 是 shape 的 下 级 节点 ， 用 来 描述 形状 图 形 内 部 的 填充 色彩 。 若 无 solid 节点 ， 则 表示 
无 填充 颜色 。 下 面 是 solid 节点 的 常用 属性 说 明 。 
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St 


color: 颜色 类 型 ， 内 部 填充 的 颜色 。 
. stroke 


roke 是 shape 的 下 级 节点 ， 用 来 描述 形状 图 形 四 周边 线 的 规格 定义 。 若 无 stroke 节点 ， 


则 表示 不 存在 描 边 。 下 面 是 stroke 节点 的 常用 属性 说 明 。 


colo: 颜色 类 型 ， 描 边 的 颜色 。 
dashGap: 像素 类 型 ， 每 段 虚线 之 间 的 间隔 。 
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e dashWidth: 像素 类 型 ， 每 段 虚线 的 宽度 。 
e width: 像素 类 型 ， 描 边 的 厚度 。 若 dashGap 和 dashWidth 有 一 个 值 为 0， 则 描 边 为 实 线 。 


在 实际 开发 中 ， 常 用 的 有 3 个 节点 : corners Af) ~ solid (填充 ) 和 stroke GB) 。 
shape 根 节点 的 属性 一 般 不 用 设置 (默认 矩形 就 好 了 ) 。 下 面 是 shape 图 形 的 XML 描述 文件 
代码 : 


<shape xmlns:android="http://schemas.android.com/apk/res/android" > 
<solid android:color="#ffdd66" /> 
«stroke 
android:width-" 1 dp" 
android:color="#ffaaaaaa" /> 
<corners 
android:bottomLeftRadius="10dp" 
android:bottomRightRadius="10dp" 
android:topLeftRadius="10dp" 
android:topRightRadius="10dp" /> 
«shape» 
对 应 的 形状 图 形 效 果 界 面 如 图 2-23. 所 示 。 该 形状 为 一 个 圆 角 和 矩形 ， 内 部 填充 色 为 土 黄色 ， 


边缘 线 为 灰色 。 








Efe Nm "muss 





图 2-23 shape 文件 定义 的 圆 角 矩形 效果 

现在 有 个 需求 ， 客 户 要 求 在 界面 上 增加 一 个 水 平分 割 线 ， 如 果 是 你 会 怎么 做 呢 ? 按照 目 
前 为 止 的 学 习 成 果 有 以 下 3 个 办 法 。 

(1) 在 TextView 控件 中 连续 填 入 许多 横 线 或 下 划 线 。 

(2) 让 美工 做 一 个 横 线 的 切 图 ， 然 后 将 ImageView 控件 塞 进 横 线 图 。 

(3) 使 用 刚 学 的 shape， 根 节点 的 shape 属性 设置 为 line 表示 直线 图 形 。 

以 上 做 法 各 有 千秋 ， 不 过 杀 鸡 焉 用 牛刀 ， 简 单 的 事情 自然 有 简单 的 办 法 。 最 简单 的 做 法 
是 在 布局 文件 中 增加 一 个 View 控件 ， 高 度 设置 为 1tp、 背 景 颜色 设置 为 线条 颜色 ， 这 样 便 实 
现 了 水 平分 割 线 的 需求 。XML 文件 的 示例 代码 如 下 : 
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<View 
android:layout width="match parent" 
android:layout height="1dp" 
android:background="#000000" /> 


244 九宫 格 图 片 


前 面 在 介绍 ImageView 时 专门 举 了 例子 说 明 不 同 拉 伸 类 型 下 的 图 片 显示 效果 。 当 图 片 被 
拉 大 时 ， 夯 面容 易 模 糊 ， 如 果 把 图 片 作 为 背景 图 ， 模 糊 的 情况 会 更 严重 。 如 图 2-24 所 示 ， 
张 按钮 图 片 被 拉 得 很 宽 ， 此 时 左右 两 边 的 边缘 线 既 变 宽 又 变 模糊 了 。 

为 了 解决 这 个 问题 ，Android 专门 设计 了 点 九 图 片 。 点 九 图 片 的 扩展 名 是 png， 文 件 名 后 
常 带 有 “.9” 字 样 。 因 为 把 一 张 图 片 划分 成 了 3x3 的 九 富 格 区 域 ， 所 以 得 名 点 九 图 片 ， 也 叫 
九宫 格 图 片 。 如 果 背 景 是 一 个 shape 图 形 ， 其 stroke 节点 的 width 属性 已 经 设置 了 具体 的 像素 
值 (如 1dp) ， 那 么 无 论 该 shape 图 形 被 拉 伸 到 多 大 ， 描 边 宽度 始终 都 是 1dp。 点 九 图 片 的 实 
现 原理 与 shape 类 似 ， 即 拉 伸 图 形 时 ， 只 对 内 部 进行 拉 伸 ， 不 对 边缘 做 拉 伸 操作 。 

为 了 演示 九宫 格 图 片 的 展示 效果 ， 首 先 我 们 要 制作 几 张 点 九 图 片 。Android 的 SDK 自 带 
点 九 图 片 的 加 工 工具 ， 路 径 是 SDK 安装 目录 下 的 sdk\tools\draw9patch.bat， 运行 该 程序 就 会 呈 
现 工 具 界面 ， 如 图 2-25 所 示 。 
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普通 图 片 背景 


九宫 格 图 片 背 录 





图 2-24 普通 图 片 与 九宫 格 图 片 的 拉 伸 效 果 对 比 图 2-25 点 九 图 片 的 制作 工具 
把 需要 加 工 的 PNG 图 片 拖 到 该 工具 界面 上 ， 图 片 就 会 加 载 到 工具 界面 ， 如 图 2-26 所 示 。 


ess Control/Shift while dragging on the border to modify layout bounds 
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图 2-26 点 九 图 片 制作 工具 的 图 片 加 载 界面 
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工具 界面 的 左 侧 窗口 是 图 片 加 工区 域 ， 右 侧 窗口 是 图 片 预 览 区 域 ， 从 上 到 下 依次 是 纵向 
拉 伸 预览 、 横 向 拉 伸 预览 、 未 拉 伸 预览 。 在 左 侧 窗口 图 片 四 周 的 马赛 克 处 单 击 会 出 现 一 个 黑 点 ， 
把 黑 点 左右 或 上 下 拖 动 会 拖 出 一 段 黑 线 ， 不 同方 向 上 的 黑 线 表示 不 同 的 效果 。 

如 图 2-27 所 示 ， 界 面 上 边 的 黑 线 指 的 是 水 平方 向 的 拉 伸 区 域 。 水 平方 向 拉 伸 图 片 时 ， 只 
有 黑 线 区 域内 的 图 像 会 拉 伸 ， 黑 线 两 边 的 图 像 保持 原状 ， 从 而 保证 左右 两 边 的 边框 厚度 不 变 。 

如 图 2-28 所 示 ， 界 面 左边 的 黑 线 指 的 是 垂直 方向 的 拉 伸 区 域 。 垂 直方 向 拉 伸 图 片 时 ， 只 
有 黑 线 区 域内 的 图 像 会 拉 伸 ， 黑 线 两 边 的 图 像 保持 原状 ， 从 而 保证 上 下 两 边 的 边框 厚度 不 变 。 


Yertical Fetch: 11 — 28 pz] 
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图 2-27 点 九 图 片上 边 的 边缘 线 图 2-28 点 九 图 片 左边 的 边缘 线 


如 图 2-29 所 示 ， 界 面 下 边 的 黑 线 指 的 是 该 图 片 作为 控件 背景 时 ， 控 件 内 部 的 文字 左右 边 
界 只 能 放 在 黑 线 区 域内 。 这 里 Horizontal Padding 的 效果 就 相当 于 android:paddingLeft 与 
android:paddingRight。 

如 图 2-30 所 示 ， 界 面 右边 的 黑 线 指 的 是 该 图 片 作为 控件 背景 时 ， 控 件 内 部 的 文字 上 下 边 
界 只 能 放 在 黑 线 区 域内 。 这 里 Vertical Padding 的 效果 就 相当 于 android:paddingTop 与 
android:paddingBottom。 





[Horizontal Padding: 7 — 112 px) 


图 2-29 点 九 图 片 下 边 的 边缘 线 图 2-30 点 九 图 片 右边 的 边缘 线 
在 实际 开发 中 ， 前 两 个 属性 使 用 的 比较 多 ， 因 为 很 多 场景 都 要 求 拉 伸 图 片 时 要 保 真 。 后 
两 个 属性 一 般 用 得 不 多 ,但 若 不 知道 ， 遇 到 问题 还 挺 麻烦 的 。 笔 者 以 前 做 开发 时 看 到 某 个 页 面 
的 文字 总 是 与 顶端 有 段 间隔 ， 可 是 无 论 怎么 调整 XML 和 代码 都 没 法 缩小 间隔 ， 后 来 才 想起 来 
检查 该 页 面 的 背景 图 片 ， 结 果 用 draw9patch.bat 打开 背景 图 发 现 该 图 片 是 点 九 图 片 ， 原 来 在 水 
平和 垂直 方向 都 设置 了 padding， 这 才 解 决 了 一 大 困惑 。 


25 KRMH: 简单 计算 器 


到 目前 为 止 , 虽然 只 学 了 一 些 Android 的 初级 控件 ， 但 是 也 可 以 学 以 致 用 ， 即 便 只 有 这 些 
简单 的 布局 和 控件 ， 也 能 够 做 出 实用 的 App。 接 下 来 我 们 设计 并 实现 一 个 简单 计算 器 。 
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254 设计 思路 


计算 器 是 人 们 日 常生 活 中 最 常用 的 工具 之 一 ， 无 论 在 电脑 上 还 是 手机 上 ， 都 少不了 计算 
器 的 身影 。 以 Windwos 上 的 计算 器 为 例 ， 界 面 简洁 且 十 分 实用 ， 程 序 界面 如 图 2-31 Bras. 

这 个 计算 器 界面 主要 分 为 两 部 分 ， 一 部 分 是 上 面 的 文本 框 ， 用 于 显示 计算 结果 ; 另 一 部 
分 是 下 面 的 几 排 按钮 , 用 于 输入 数字 与 各 种 运算 符 。 为 了 减少 复杂 度 , 我 们 可 以 精简 一 些 功能 ， 
只 保留 数字 与 加 、 减 、 乘 、 除 四 则 运算 ， 另 外 补充 一 个 开 根 号 〈 求 平方 根 ) 的 运算 。 至 于 App 
的 显示 界面 ， 基 本 与 习惯 的 计算 器 界面 保持 一 致 ， 经 过 对 操作 按钮 的 适当 排列 ， 调 整 后 的 设计 





效果 如 图 2-32 所 示 。 
el m 编辑 (E) 简单 计算 器 
| = 





[uc] mr || ms || me || m- | CE * x C 











== 4 5 6 |: 
1 EEEE 

0 5 [o 
图 2-31 Windows 的 计算 器 图 2-32 简单 计算 器 的 设计 效果 图 


这 个 计算 器 虽然 小 巧 ， 但 是 基本 襄 括 了 本 章 的 知识 点 ， 先 来 看 看 用 了 哪些 控件 。 


e 线性 布局 LinearLayout: 计算 器 界面 整体 上 是 从 上 往 下 布局 的 ， 所 以 需要 垂直 方向 的 
LinearLayout; 下 面部 分 每 行 都 有 4 个 按钮 ， 又 需要 水 平方 向 的 LinearLayout。 

e 滚动 视图 ScrollView: 虽然 计算 器 界面 不 宽 也 不 高 ， 但 是 以 防 万 一 ， 最 好 还 是 加 个 垂直 
方向 的 ScrollView。 

e 文本 视图 TextView: 很 明显 上 方 标题 “简单 计算 器 ”就 是 TextView， 下 面 的 计算 结果 也 需 
要 使 用 TextView， 而 且 是 能 够 自动 从 下 往 上 滚动 的 TextView， 即 聊天 室 效 果 的 文本 视图 。 

e 按钮 Button: 绝 大 多 数 数字 与 运算 符 按钮 都 采用 Button 控件 。 

e 图 像 视 图 ImageView: 暂时 未 用 到 。 

e 图 像 按 钮 ImageButton: 开 根 号 的 运算 符 “w” 虽 然 能 够 打出 来 ， 但 是 右上 角 少 了 数学 课 
本 上 的 一 横 ， 所 以 该 按钮 要 用 一 张 标 准 的 开 根 号 图 片 显示 ， 这 就 用 到 了 ImageButton。 

° 状态 列表 图 形 : 每 个 按钮 都 有 按 下 和 弹 起 两 种 状态 , 这 里 定制 了 按钮 控件 的 自 定义 样式 ， 
因此 用 到 了 状态 列表 图 形 。 

e° 形状 图 形 : 运算 结果 用 到 的 文本 视图 边框 是 圆 角 算 形 ， 所 以 得 给 它 定义 一 个 shape 文件 ， 
把 shape 定义 的 圆 角 年 形 作为 文本 视图 的 背景 。 


* 53 。 
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e 九宫 格 图 片 : 注意 计算 器 界面 左下 角 的 “0”， 该 按钮 是 其 他 按钮 的 两 倍 宽 ， 如 果 使 用 普 
通 图 片 当 背景 ， 势 必 造 成 边缘 线 被 拉 宽 、 拉 模糊 的 问题 ， 故 而 要 采用 点 九 图 片 避 兔 这 种 
情况 。 
经 过 对 计算 器 效果 图 的 详细 分 析 ， 我 们 初步 了 解 了 所 运用 的 控件 技术 ， 接 下 来 就 可 以 对 
界面 进行 布局 和 排列 了 。 
2.5.2 ”小 知识 : 日 志 Log/ 提 示 Toast 
在 正式 编码 之 前 ， 读 者 有 必要 了 解 一 下 Android 中 的 运行 信息 调试 手段 。 例 如 ， 开 发 C 
程序 时 , 我 们 常常 用 printf 函数 输出 程序 日 志 ; 开发 Java 程序 时 , 我 们 常常 用 System.outprintln 


函数 输出 程序 日 志 。 同 样 ，App 开发 也 有 相应 的 函数 输出 提示 信息 。 提 示 信 息 可 分 为 两 类 ， 
类 是 给 开发 者 看 的 ， 另 一 类 是 给 用 户 看 的 。 

















1. Log 


给 开发 者 看 的 提示 信息 要 调用 Log 类 的 相应 方法 , 日 志 打印 结果 可 在 Android Studio 界面 
下 方 的 logcat 小 窗口 查看 。Log 类 各 种 方法 的 区 别 在 于 日 志 的 等 级 ， 有 具体 说 明 如 下 。 


Loge: 表示 错误 信息 ， 比 如 可 能 导致 程序 崩溃 的 异常 。 

Log.w: 表示 警告 信息 。 

Logi: 表示 一 般 消息 。 

Log.d: 表示 调试 信息 ， 可 把 程序 运行 时 的 变量 值 打 印 出 来 ， 方 便 跟踪 调试 。 
Log.v: 表示 宛 余 信息 。 


2. Toast 


给 用 户 看 的 提示 信息 要 调用 Toast 类 的 相应 方法 , 提示 文字 会 在 屏幕 下 方 以 一 个 小 窗口 临 
时 展现 。 对 于 计算 器 来 说 ， 有 好 几 种 情况 需要 提示 用 户 ， 如 “被 除数 不 能 为 0”“ 开 根 号 的 数 
值 不 能 小 于 0” 等 。 
Toast 的 简单 用 法 只 需 一 行 代码 就 可 以 了 ， 示 例 代码 如 下 : 
Toast.makeText(MainActivity.this, "提示 文字 ", Toast. LENGTH_SHORT).show(); 


另外 ， 计 算 器 每 个 按钮 的 展示 风格 基本 相同 ， 为 了 减少 元 余 代 码 ， 可 将 相同 的 样式 定义 
写 在 values 目录 下 的 styles.xml 文件 中 ， 然 后 在 布局 文件 节点 下 增加 style="@style/btn_cal" 这 
样 的 属性 定义 。 下 面 是 styles.xml 中 计算 器 按钮 风格 定义 的 例子 : 


<style name="btn_cal"> 
«item name="android:layout_ width">0dp</item> 
«item name-"android:layout height"»match parent-/item 
«item name-"android:layout weight">1</item> 
«item name-"android:gravity"»center-/item 
«item name-"android:textColor"-(g/color/black-/item- 
«item name="android:textSize">30sp</item> 
«item name-"android:background"- (gdrawable/btn nine selectorc/item^ 
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</style> 
2.5.8 ”代码 示例 


看 到 这 里 ， 估 计 读 者 对 计算 器 App 的 布局 和 代码 框架 都 
了 然 于 胸 了 ， 接 下 来 介绍 一 些 业 务 逻辑 判断 与 基本 的 数学 四 
则 运算 。 只 要 设计 充分 并 且 合 理 , 编码 就 会 很 快 。 计算 器 App 
运行 后 的 计算 效果 如 图 2-33 所 示 。 

编码 过 程 主要 分 为 3 个 步骤 : 

Eo 先 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 代码 文件 
取 名 CalculatorActivityjava、 布 局 文件 取 名 activity_calculatorxml。 
记得 在 AndroidManifestxml 中 注册 acitivity 节点 ， 不 然 App 运行 
时 会 报 ActivityNotFoundException 异常 , 具体 是 在 application 节点 
下 补充 一 行 声明 : 








«activity android:name=".CalculatorActivity" /> 


ED 在 res/layout 目录 下 创建 布局 文件 activity. calculator.xml, 按照 简单 计算 器 的 效果 图 在 里 








面 填 入 各 控件 的 布局 结构 ， 并 指定 相关 的 属性 定义 。 














中 定义 的 界面 布局 。 接 着 编写 具体 的 控件 操作 与 业务 代码 。 
下 面 是 计算 器 App 的 主要 业务 代码 片段 : 
public void onClick(View v) { 
int resid = v.getld(); 
String inputText; 
if (resid = R.id.ib_sqrt) í 
inputText = " V"; 
} else { 
inputText = ((TextView) v).getText().toString(); 
5 
Log.d(TAG, "resid="+resid+",inputText="+inputText); 
if (resid = R.id.btn clear) í 
clear(""); 
} else if (resid == R.id.btn cancel) í 
if (operator.equals("") — true) { 
if (firstNum.length() = 1) í 
firstNum = "0"; 
} else if (firstNum.length() > 0) í 
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简单 计算 器 
1+3=4x9=36V=6.0-1.5=4 - 2=2x99= 
198+7=28.2857142857x3=84.85714 
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233 简单 计算 器 的 运行 效果 图 














Eo 在 项 目的 包 名 目录 下 创建 CalculatorActivity 类 , 仿照 MainActivity 代码 在 onCreate 内 部 
内 setContentView 方法 中 填 入 参数 R.layout.activity_calculator， 表 示 该 页 面 使 用 activity calculator.xml 


firstNum = firstNum.substring(0, firstNum.length() - 1); 


} else í 


Toast.makeText(this, "没有 可 取消 的 数字 了 ", Toast. LENGTH. SHORT).show(); 
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return; 
j 
showText = firstNum; 
tv_result.setText(showText); 
) else í 
if (nextNum.length() — 1) í 
nextNum = ""; 
} else if (nextNum.length() > 0) í 
nextNum = nextNum.substring(0, nextNum.length() - 1); 


} else í 
Toast.makeText(this, "没有 可 取消 的 数字 了 ", Toast. LENGTH_SHORT).show(); 
return; 

j 


showText = showText.substring(0, showText.length() - 1); 
tv result.setText(showText); 

1 

1 else if (resid == R.id.btn_equal) í 

if (operator.length() — 0 || operator.equals(" =") == true) ( 
Toast.makeText(this, "请 输入 运算 符 ", Toast. LENGTH. SHORT ).show(); 
return; 

} else if (nextNum.length() <= 0) í 
Toast. makeText(this, "请 输入 数字 ", Toast.LENGTH. SHORT).show(); 
return; 

j 

if (caculate() = true) { 
operator — inputText; 
showText = showText + "=" + result; 
tv_result.setText(showText); 

) else í 
return; 

j 

} else if (resid = R.id.btn plus || resid = R.id.btn minus 

|| resid = R.id.btn multiply || resid = R.id.btn divide ) í 

if (firstNum.length() <= 0) í 
Toast.makeText(this, "请 输入 数字 ", Toast. LENGTH. SHORT).show(); 
return; 

} 

if (operator.length() — 0 || operator.equals(" =") = true || operator.equals(" 4 ") = true) í 
operator = inputText; // 操作 符 
showText — showText operator; 
tv result.setText(showText); 

} else ( 
Toast.makeText(this, "请 输入 数字 ", Toast. LENGTH. SHORT).show(); 
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return; 
1 
} else if (resid = R.id.ib sqrt) í 

if (firstNum.length() <= 0) í 
Toast.makeText(this, "请 输入 数字 ", Toast. LENGTH. SHORT).show(); 
return; 

} else if (Double.parseDouble(firstNum) < 0) í 
Toast.makeText(this, " 开 根 号 的 数值 不 能 小 于 0", Toast.LENGTH. SHORT).show(); 
return; 

j 

result = String.valueOf( Math.sqrt( Double.parseDouble( firstNum))); 

firstNum - result; 

nextNum = ""; 

operator = input Text; 

showText = showText + " V=" + result; 

tv_result.setText(show Text); 

Log.d(TAG, "result="+result+" firstNum="+firstNum+",operator="+operator); 

) else í 

if (operator.equals(" —") == true) í 
operator — ""; 
firstNum = ""; 
showText = ""; 

j 

if (resid = R.id.btn dot) í 
inputText = "."; 

Ë 

if (operator.equals("") = true) { 
firstNum = firstNum + inputText; 

} else ( 
nextNum = nextNum + inputText; 

j 

showText = showText + inputText; 

tv result.set Text(showText); 


j 


private String operator = ""; // 操作 符 
private String firstNum = ""; // 前 一 个 操作 数 
private String nextNum ="; // 后 一 个 操作 数 
private String result ="; // 当前 计算 结果 
private String showText= ""; / 显示 的 文本 内 容 
private boolean caculate() { // 开始 加 减 乘除 四 则 运算 

if (operator.equals(" +") — true) í 

result = String.valueOf(Arith.add(firstNum, nextNum)); 
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} else if (operator.equals(" —") = true) í 
result = String.valueOf( Arith.sub(firstNum, nextNum)); 
} else if (operator.equals("x") = true) í 
result = String.valueOf( Arith.mul(firstNum, nextNum)); 
} else if (operator.equals("-") = true) í 
if ("0".equals(nextNum)) í 
Toast.makeText(this, "被 除数 不 能 为 零 ", Toast. LENGTH. SHORT).show(); 
return false; 
} else { 
result = String.valueOf(Arith.div(firstNum, nextNum)); 


private void clear(String text) { // 清空 并 初始 化 
showText = text; 
tv_result.setText(showText); 
operator = ""; 
firstNum = ""; 
nextNum = ""; 


result = ""; 


26 小 结 


本 章 主要 介绍 App 开发 初级 控件 的 相关 知识 , 包括 屏幕 显示 基础 像素、 颜色 、 分 状 率 )、 
简单 布局 的 用 法 〈 基 本 视图 、 线 性 布局 、 滚 动 视图 ) 、 简 单 控件 的 用 法 (文本 视图 、 按 钮 、 图 
像 视 图 、 图 像 按 钮 ) 、 简 单 图 形 的 用 法 〈 状 态 列 表 图 形 、 形 状 图 形 、 九 宫 格 图 片 ) 。 最 后 设计 
了 一 个 实战 项 目 “ 简 单 计算 器 ”， 在 该 项 目的 App 编码 中 运用 了 前 面 介绍 的 大 部 分 简单 布局 
和 控件 ， 从 而 加 深 了 对 所 学 知识 的 理解 ; 并 初步 使 用 Log 和 Toast, Jy App 开发 培养 良好 的 编 
码 和 调试 习惯 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 掌握 以 下 3 种 开发 技能 


(1) 在 布局 文件 中 合理 使 用 本 章 学 到 的 布局 和 控件 。 
(2) 在 代码 中 合理 调用 本 章 学 到 的 布局 和 控件 的 相关 方法 。 
(3) 学 会 制作 并 使 用 简单 的 图 形 描 述 文件 ， 包 括 九 宫 格 图 片 。 





S manh 


本 章 介绍 App 开发 常用 的 一 些 中 级 控件 及 相关 工具 ， 
主要 包括 其 他 布局 用 法 、 特 殊 按钮 的 用 法 、 下 拉 框 与 基本 适 
配器 的 用 法 、 编 辑 框 的 用 法 等 ， 另 外 介绍 四 大 组 件 之 一 的 
Activity 的 基本 概念 与 常见 用 法 。 最 后 结合 本 章 所 学 的 知识 
演示 一 个 实战 项 目 “ 登 录 App” 的 设计 与 实现 。 
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3.1. 其 他 布局 


本 节 介绍 Android 另外 两 个 常用 的 布局 视图 ， 分 别 是 相对 布局 RelativeLayonut 的 属性 说 明 
与 注意 点 、 框 架 布 局 FrameLayout 的 属性 说 明 与 注意 点 。 


3.1.1 相对 布局 RelativeLayout 


RelativeLayout 下 级 视图 的 位 置 是 相对 位 置 ， 得 有 有 具体 的 参照 物 才能 确定 最 终 位 置 。 如 果 
不 设 定 下 级 视图 的 参照 物 ， 那 么 下 级 视图 默认 显示 在 RelativeLayout 内 部 的 左上 角 。 用 于 确定 
视图 位 置 的 参照 物 分 两 种 ， 一 种 是 与 该 视图 自身 平 级 的 视图 ， 另 一 种 是 该 视图 的 上 级 视图 
(RelativeLayout) 。 与 参照 物 对 比 ， 相 对 位 置 的 属性 与 类 型 值 见 表 3-1。 


表 3-1 相对 位 置 的 属性 与 类 型 的 取 值 说 明 


XML 中 的 相对 位 置 属 性 RelativeLayout 类 的 相对 位 置 相对 位 置 说 明 


























layout_toLeftOf LEFT_OF 当前 视图 在 指定 视图 的 左边 

layout. toRightOf RIGHT OF 当前 视图 在 指定 视图 的 右边 

layout above ABOVE 当前 视图 在 指定 视图 的 上 方 
layout_below BELOW 当前 视图 在 指定 视图 的 下 方 
layout_alignLeft ALIGN LEFT 当前 视图 与 指定 视图 的 左 侧 对 齐 
layout_alignRight ALIGN RIGHT 当前 视图 与 指定 视图 的 右 侧 对 齐 
layout_alignTop ALIGN TOP 当前 视图 与 指定 视图 的 顶部 对 齐 
layout_alignBottom ALIGN_BOTTOM 当前 视图 与 指定 视图 的 底部 对 齐 
layout_centerInParent CENTER IN PARENT 当前 视图 在 上 级 视图 中 间 
layout_centerHorizontal CENTER_HORIZONTAL 当前 视图 在 上 级 视图 的 水 平方 向 居中 
layout_centerVertical CENTER_VERTICAL 当前 视图 在 上 级 视图 的 垂直 方向 居中 
layout_alignParentLeft ALIGN PARENT LEFT 当前 视图 与 上 级 视图 的 左 侧 对 齐 
layout_alignParentRight ALIGN PARENT RIGHT 当前 视图 与 上 级 视图 的 右 侧 对 齐 
layout_alignParentTop ALIGN PARENT TOP 当前 视图 与 上 级 视图 的 顶部 对 齐 
layout alignParentBottom ALIGN PARENT BOTTOM 当前 视图 与 上 级 视图 的 底部 对 齐 





为 了 更 好 地 理解 上 述 相 对 属性 的 含义 , 接 下 来 使 用 RelativeLayout 及 其 下 级 视图 进行 布局 ， 
看 看 实际 效果 图 是 怎样 的 。 下 面 是 演示 相对 布局 的 XML 代码: 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"500dp" > 
«Button 
android:id-"(g)*id/btn center" 
style="(@style/btn relative" 
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android:layout_centerInParent="true" 
android:text=" 我 在 中 间 " > 
<Button 
android:id="(@+id/btn_center_horizontal" 
style="(@style/btn relative" 
android:layout centerHorizontal-"true" 
android:text-" E K^F rh [i]" /> 
«Button 
android:id-"(g)*id/btn center vertical" 
style-"(a)style/btn relative" 
android:layout centerVertical-"true" 
android:text=" 我 在 垂直 中 间 " /> 
<Button 
android:id="(@+id/btn_parent_left" 
style="(@style/btn_relative" 
android:layout_marginTop="100dp" 
android:layout_alignParentLeft="true" 
android:text=" 我 跟 上 级 左边 对 齐 " > 
<Button 
android:id="@+id/btn_parent_top" 
style-"(astyle/btn relative" 
android:layout width-"120dp" 
android:layout. alignParentTop-"true" 
android:text=" 我 跟 上 级 项 部 对 齐 " > 
<Button 
android:id="(@+id/btn parent right" 
style="(@style/btn relative" 
android:layout marginTop-"100dp" 
android:layout. alignParentRight-"true" 
android:text=" 我 跟 上 级 右边 对 齐 " > 
«Button 
android:id-"(g)*id/btn parent bottom" 
style-"(astyle/btn relative" 
android:layout width-"120dp" 
android:layout alignParentBottom-"true" 
android:layout centerHorizontal-"true" 
android:tex 人 "我 跟 上 级 底部 对 齐 " > 
<Button 
android:id-"(g)*id/btn left bottom" 
style-"(a)style/btn relative" 
android:layout toLeftOf-"(g)*id/btn parent bottom" 
android:layout alignTop-"(g)*id/btn parent bottom" 
android:text=" 我 在 底部 左边 " /> 
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<Button 
android:id="@+id/btn_right_bottom" 
style="(@style/btn relative" 


android:layout_toRightOf="(@+id/btn parent bottom" 


android:layout alignBottom-"(g)*id/btn parent bottom" 


android:text=" 我 在 底部 右边 " /> 

<Button 
android:id="@+id/btn_above_center" 
style=" @style/btn_relative" 
android:layout_above="(@+id/btn_center" 
android:layout_alignLeft="@+id/btn_center" 
android:text=" 我 在 中 间 上 面 " /> 

<Button 
android:id="@+id/btn_below_center" 
style-"(Qstyle/btn relative" 
android:layout below-"(a)*id/btn center" 
android:layout. alignRight-"(a)*id/btn center" 
android:text-" JE rP lB] F ri" /> 

«/RelativeLayout^ 


上 述 布 局 文件 的 效果 如 图 3-1 所 示 ， 
RelativeLayout 的 下 级 视图 为 各 个 按钮 控件 , 按钮 上 的 
文字 说 明了 所 处 的 相对 位 置 ， 具 体 的 控件 显示 方位 正 
如 XML 属性 中 描述 的 那样 。 

- 般 我 们 在 布局 文件 中 就 定义 好 了 视图 的 相对 位 
置 ， 很 少 会 等 到 在 代码 中 定义 。 不 过 也 有 特殊 情况 ， 
如 果 视 图 是 在 代码 中 动态 添加 的 ， 那 么 相对 位 置 也 只 
能 在 代码 中 临时 定义 。 代 码 中 定义 相对 位 置 用 到 的 是 
RelativeLayout.LayoutParams 的 addRule 方法 , 该 方法 
的 第 一 个 参数 表示 相对 位 置 的 类 型 ， 具 体 取 值 说 明 见 
表 3-1; 第 二 个 参数 表示 参照 物 视图 的 ID， 即 当前 视 
图 要 参照 哪个 视图 确定 自身 位 置 。 

下 面 是 在 代码 中 给 RelativeLayout 动态 添加 子 视 
图 并 指定 子 视图 相对 位 置 的 代码 片段 : 

public void onClick(View v) í 
if (v.getld() — R.id.btn add left) ( 





RRR 我 在 水 平 中 间 
部 对 齐 
我 跟 上 级 左边 对 齐 我 跟 上 级 右边 对 齐 
我 在 中 间 上 面 
我 在 垂直 中 间 我 在 中 间 
我 在 中 间 下 面 


我 在 底部 左边 ”我 跟 上 级 底 
部 对 齐 。 ”我 在 底部 右边 


图 3-1 在 布局 文件 中 定义 的 相对 布局 


addNewView(RelativeLayout.LEFT_OF, RelativeLayout.ALIGN TOP, v.getld()); 


) else if (v.getld() — R.id.btn add above) í 


addNewView(RelativeLayout.ABOVE, RelativeLayout.ALIGN LEFT, v.getld()); 


} else if (v.getld() = R.id.btn add right) í 


addNewView(RelativeLayout.RIGHT OF, RelativeLayouLALIGN BOTTOM, v.getId()); 
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} else if (v.getld() = R.id.btn_add below) í 
addNew View(RelativeLayout.BELOW, RelativeLayout.ALIGN RIGHT, v.getld()); 
} else if (v.getId() = R.id.btn add center) { 
addNewView(RelativeLayout. CENTER IN PARENT, -1, rl content.getId()); 
} else if (v.getId() = R.id.btn add parent left) í 
addNewView(RelativeLayouL. ALIGN PARENT LEFT, RelativeLayout. CENTER - 
VERTICAL, rl. content.getId()); 
} else if (v.getId() = R.id.btn add parent top) í 
addNew View(RelativeLayout. ALIGN PARENT TOP, RelativeLayout. CENTER - 
HORIZONTAL, rl content.getId()); 
} else if (v.getld() = R.id.btn add parent right) í 
addNew View(RelativeLayouL ALIGN PARENT RIGHT, -1, rl content.getId()); 
} else if (v.getId() = R.id.btn add parent bottom) í 
addNewView(RelativeLayouL ALIGN PARENT BOTTOM, -1, rl content.getId()); 


private void addNew View(int firstAlign, int secondAlign, int referld) í 
View v = new View(this); 
v.setBackgroundColor(0xaa661T66); 
RelativeLayout.LayoutParams rl params — new RelativeLayout.LayoutParams(100, 100); 
rl params.addRule(firstAlign, referId); 
if (secondAlign >= 0) í 
rl params.addRule(secondA lign, referld); 
J 
v.setLayoutParams(rl params); 
v.setOnLongClickListener(new OnLongClickListener() í 
@Override 
public boolean onLongClick(View vv) { 
rl content.removeView(vv); 
retum true; 


» 
rl content.addView(v); 


D 
动态 添加 子 控件 的 效果 如 图 3-2 所 示 , 在 图 上 给 每 个 方块 子 视图 做 了 编号 ,以 此 区 分 该 方 
块 是 由 哪个 按钮 添加 的 以 及 添加 的 相对 位 置 。 
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点 击 按钮 添加 视 国 ， 长 彼 视 图 删除 自身 


7 8 


2 
IB 潭 加 左边 视图 


添加 上 方 视图 
添加 右边 视图 
添加 下 方 视图 
FREIEN 
Lo Mp 
添加 上 级 顶部 对 齐 视图 
添加 上 级 右 侧 对 齐 视图 
添加 上 级 底部 对 天 视图 








图 3-2 在 代码 中 动态 添加 下 级 视图 的 相对 布局 
3.4.2 ”框架 布局 FrameLayout 


FrameLayout 也 是 较 常用 的 布局 ， 其 下 级 视图 无 法 指定 所 处 的 位 置 ， 只 能 统统 从 上 级 
FrameLayout 的 左上 角 开 始 添加 ， 并 且 后 面 添加 的 子 视图 会 把 之 前 的 子 视图 覆盖 掉 。 框 架 布 局 
- 般 用 于 需要 重 有 显示 的 场合 ， 比 如 绘图 、 游 戏 界面 等 ， 常 见 属性 说 明 如 下 。 
e foreground: 指定 框架 布局 的 前 景 图 像 。 该 图 像 在 框架 内 部 永远 处 于 最 顶层 ， 不 会 被 框架 
内 的 其 他 视图 覆盖 。 
e foregroundGravity: 指定 前 景 图 像 的 对 齐 方式 。 该 属性 的 取 值 说 明 同 gravity. 


为 了 更 直观 地 理解 FrameLayout， 我 们 可 在 代码 中 为 框架 布局 动态 添加 子 视 图 ， 然 后 观察 
前 后 两 个 子 视图 的 显示 效果 。 

先 给 框架 布局 添加 一 个 暗 灰 色 的 子 视图 ， 如 图 3-3 所 示 。 再 给 框架 布局 添加 一 个 鲜红 色 子 
视图 ， 如 图 3-4 所 示 。 此 时 后 面 添加 的 视图 会 覆盖 前 面 添加 的 视图 。 注 意 ， 框 架 视 图 上 方正 中 
间 的 小 图 标 一 直 都 没 被 覆盖 ， 是 它 被 指定 为 前 景 图 像 的 缘故 。 


de 


给 下 方 的 帆布 局 添加 视图 给 下 方 的 山 布 局 添加 视图 








图 3-3 在 框架 布局 中 添加 第 一 个 子 视图 图 34 在 框架 布局 中 添加 第 二 个 子 视图 








中 级 控件 # 33 





除了 线性 布局 、 相 对 布局 、 框 架 布 局 外 ，Android 还 提供 了 其 他 几 个 布局 视图 ， 如 绝对 布 
局 AbsoluteLayout、 表 格 布局 TableLayout 等 ， 不 过 这 几 个 布局 在 实际 开发 中 用 得 并 不 多 ， 读 
者 只 需 掌握 前 3 种 布局 就 可 以 了 。 


3.2 ”特殊 按钮 


本 节 介 绍 几 个 常用 的 特殊 控制 按钮 ,包括 复 选 框 CheckBox 的 监听 器 用 法 、 开 关 按钮 Switch 
的 属性 定义 、 仿 iOS 开关 按钮 的 实现 、 单 选 按钮 RadioButton 及 其 组 布局 RadioGroup 的 监听 
器 用 法 ， 以 及 如 何 更 换 这 些 控 件 的 按钮 图 标 。 


3.2.1 复 选 框 CheckBox 


在 学 习 复 选 框 之 前 ， 先 了 解 一 下 CompoundButton。 在 Android 体系 中 ，CompoundButton 
类 是 抽象 的 复合 按钮 , 因为 是 抽象 类 , 所 以 不 能 直接 使 用 。 实 际 开发 中 用 的 是 CompoundButton 
类 的 几 个 派生 类 ， 主 要 有 复 选 框 CheckBox、 单 选 按钮 RadioButton 以 及 开关 按钮 Switch, 3X 
些 派 生 类 都 可 使 用 CompoundButton 的 属性 和 方法 。 

CompoundButton 在 布局 文件 中 主要 使 用 下 面 两 个 属性 。 


e checked: 指定 按钮 的 勾 选 状态 ，true 表示 勾 选 ，false 表示 未 义 选 。 默 认 未 勾 选 。 
e button: 指定 左 侧 勾 选 图 标的 图 形 。 如 果 不 指定 就 使 用 系统 的 默认 图 标 。 


CompoundButton 在 代码 中 可 使 用 下 列 4 种 方法 进行 设置 。 


e setChecked: 设置 按钮 的 勾 选 状态 。 

e setButtonDrawable: 设置 左 侧 勾 选 图 标的 图 形 。 

e setOnCheckedChangeListener: 设置 义 选 状态 变化 的 监听 器 。 
e isChecked: 判断 按钮 是 否 勾 选 。 


复 选 框 CheckBox 是 CompoundButton 一 个 最 简单 的 实现 ， 点 击 复 选 框 勾 选 ， 再 次 点 击 取 
消 勾 选 。CheckBox 通过 setOnCheckedChangeListener 方法 设置 勾 选 监听 器 ， 对 应 的 监听 器 要 
实现 接口 CompoundButton.OnCheckedChangeListener。 下 面 是 复 选 框 自 定义 勾 选 监听 器 的 代码 : 


private class CheckListener implements CompoundButton.OnCheckedChangeListener{ 
@Override 
public void onCheckedChanged(CompoundButton button View, boolean isChecked) í 
String desc = String.format(" 您 勾 选 了 控件 %d， 状 态 为 %b", buttonView.getld(), 
isChecked); 
Toast.makeText(MainActivity.this, desc, Toast. LENGTH_LONG).show(); 


$ 


要 更 换 复 选 框 左 侧 的 勾 选 图 像 ， 可 将 button 属性 修改 为 自 定义 的 勾 选 图 形 。 下 面 是 一 个 
勾 选 图 形状 态 定义 的 例子 ， 如果 是 色 选 状态 ， 就 显示 图 形 check choose; 如 果 取 消 勾 选 ， 就 显 
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示 图 形 check_unchoose。 


«selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:state checked="true" android:drawable="(@drawable/check_choose"/> 
<item android:drawable="(@drawable/check_unchoose"/> 

</selector> 


3.22 ”开关 按钮 Switch 
Switch 是 开关 按钮 ，Android 从 4.1.2 版 本 开始 支持 该 控件 。 其 实 Switch 是 一 个 高 级 版 本 
的 CheckBox， 在 选中 与 取消 选中 时 可 展现 的 界面 元 素 比 CheckBox 丰富 。Switch 新 添加 的 属 
性 和 设置 方法 见 表 3-2。 
表 3-2 Switch 控件 的 属性 和 设置 方法 说 明 
XML 中 的 属性 | Switch 类 的 设置 方法 | 说 明 


textOn setTextOn 设置 右 侧 开启 时 的 文本 
textOff setTextOfr 设置 左 侧 关闭 时 的 文本 
switchPadding setSwitchPadding 设置 左右 两 个 开关 按钮 之 间 的 距离 
thumbTextPadding | setThumbTextPadding | 设置 文本 左右 两 边 的 距离 。 如 果 设 置 了 该 属性 ，switchPadding 属 
性 就 会 失效 
thumb setThumbDrawable 设置 开关 轨道 的 背景 
setThumbResource 
track setTrackDrawable 设置 开关 标识 的 图 标 
setTrackResource 





Switch 是 升级 版 的 CheckBox， 实 际 开 发 中 用 得 不 多 。 原 因 之 一 是 大 家 觉得 Switch 的 默认 
JR EH. WE 3-5 和 图 3-6 所 示 ， 方 方正 正 的 图 标 有 点 土 又 有 点 呆板 ;原因 之 二 是 iPhone 
作为 高 大 上 手机 的 代表 ， 大 家 都 觉得 iOS 的 UI 很 漂亮 ,于 是 无 论 是 用 户 还 是 客户 ， 都 希望 
App 做 得 与 iOS 控件 相像 ，iOS 的 开关 按钮 UISwitch 就 成 了 大 家 仿照 的 对 象 。 











Switeh 开 关 ; Switch 开关 : 
Switch 技 钮 的 状态 是 关 Switch 按钮 的 状态 是 开 
3-5 Switch 控件 的 “ 关 ” 状 态 图 3-6 Switch 控件 的 “ 开 ” 状 态 


现在 我 们 要 让 Android 实现 类 似 iOS 的 开关 按钮 ， 主 要 思路 是 借助 状态 列表 图 形 
StateListDrawable， 首 先 定义 一 个 状态 列表 ，XML 的 代码 如 下 : 
«selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:state checked-"true" android:drawable="(@drawable/switch_on"/> 
<item android:drawable-"(g drawable/switch off"/^ 
</selector> 
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然后 把 CheckBox 控件 的 background 属性 设置 为 该 状态 图 形 ， 当 然 button 属性 要 先 设置 
为 @null。 为 什么 这 里 修改 background 属性 ， 而 不 直接 修改 button 属性 呢 ? 因为 button 属性 是 
有 限制 的 , 无 论 多 大 的 图 片 , 都 只 显示 一 个 小 小 的 图 标 , 可 是 小 小 的 图 标 怎么 能 体现 用 户 高 大 
上 的 身份 呢 ? 所 以 这 里 必须 使 用 background， 要 它 有 多 大 就 能 有 多 大 ， 这 才 够 粹 、 够 档次 。 
最 后 看 看 这 个 仿 iOS 开关 按钮 的 效果 ， 如 图 3-7 和 图 3-8 所 示 。 这 下 开关 按钮 脱胎 换 骨 ， 
又 圆 又 鲜艳 ， 看 起 来 好 看 很 多 。 














Middle Middle 


仿 i0S 的 开关 : 仿 i0S 的 开关 : «5 


仿 i0S 开 关 的 状态 是 关 仿 iOS 开 关 的 状态 是 开 





图 3-7 (j iOS 按钮 的 “ 关 ” 状 态 图 3-8 仿 iOS 按钮 的 “ 开 ” 状 态 
3.2.3 ” 单 选 按钮 RadioButton 


单 选 按钮 要 在 一 组 按钮 中 选择 其 中 一 项 ， 并 且 不 能 多 选 ， 这 要 求 有 个 容器 确定 这 组 按钮 
的 范围 ， 这 个 容器 便 是 RadioGroup。RadioGroup 实质 上 是 个 布局 , 同一 组 RadioButton 都 要 放 
在 同一 个 RadioGroup 节点 下 。RadioGroup 有 orientation 属性 可 指定 下 级 控件 的 排列 方向 ， 该 
属性 为 horizontal 时 ， 单 选 按钮 在 水 平方 向 排列 ， 该 属性 为 vertical 时 ， 单 选 按钮 在 垂直 方向 
排列 。RadioGroup 下 面 除了 RadioButton， 还 可 以 挂 载 其 他 子 控件 (如 TextView、ImageView 
等 ) 。 这 样 看 来 ，RadioGroup 就 是 一 个 特殊 的 线性 布局 ， 只 不 过 多 了 管理 单 选 按 钮 的 功能 。 
下 面 是 RadioGroup 常用 的 3 个 方法 。 


e check: 选中 指定 资源 编号 的 单 选 按钮 。 
e getCheckedRadioButtonId: 获取 选中 状态 单 选 按钮 的 资源 编号 。 
e setOnCheckedChangeListener: 设置 单 选 按钮 勾 选 变化 的 监听 器 。 


RadioButton 默认 未 选中 ， 点 击 后 显示 选中 ， 但 是 再 次 点 击 不 会 取消 选中 。 只 有 点 击 同 组 
的 其 他 单 选 按钮 时 ， 原 来 选中 的 单 选 按钮 才 会 取消 选中 。 另 外 , 单 选 按钮 的 选中 事件 一 般 不 由 
RadioButton 处 理 ， 而 是 由 RadioGroup 响应 。 选 中 事件 在 实现 时 ， 首 先 要 写 一 个 选中 监听 器 实 
IL 接 Fl  RadioGroup.OnCheckedChangeListener , 然 后 调用 RadioGroup 对 象 的 
setOnCheckedChangeListener 方法 注册 该 监听 器 。 
下 面 是 用 RadioGroup 实现 选中 监听 器 的 代码 : 
class RadioListener implements RadioGroup.OnCheckedChangeListener{ 
(QOverride 
public void onCheckedChanged(RadioGroup group, int checkedId) í 
Toast.makeText(MainActivity.this, "您 选中 了 控件 "+checkedId, 
Toast.LENGTH_LONG).show(); 
h 





x 
RadioButton 经 常会 更 换 按 钮 图 标 ， 如 果 通 过 button 属性 变更 图 标 ， 那 么 图 标 与 文字 就 会 
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挨 得 很 近 ， 如 图 3-9 所 示 的 第 一 个 单 选 按钮 。 为 了 拉 开 图 标 与 文字 之 间 的 距离 ， 得 换 成 
drawableLeft 属性 展示 新 图 标 〈 不 要 忘 了 把 button 改 为 @null) ， 此 时 再 设置 drawablePadding 
即 可 指定 间隔 距离 。 修 改 后 的 单 选 按钮 效果 如 图 3-10 所 示 ， 可 以 看 到 图 标 与 文字 之 间 的 距离 
明显 增 大 了 。 














请 选择 您 的 婚姻 状况 请 选择 您 的 婚姻 状况 
O = 未 婚 
已 婚 Q Ps 
哇 哦 ， 你 的 前 途 不 可 限量 哇 哦 ， 祝 你 早生 贵子 
图 3-9 图 标 设置 在 button 属性 上 3-10. 图标 设置 在 drawableLeft 属性 上 


前 面 给 不 同 的 按钮 自 定义 按钮 图 标 先 后 用 了 3 个 属性 , 即 自 定义 CheckBox 图 标 时 的 button 
属性 、 仿 iOS 开关 按钮 时 的 background 属性 以 及 自 定义 RadioButton 时 的 drawableLeft 属性 。 
下 面 总 结 一 下 这 3 个 图 标 设置 方式 分 别 适用 的 场合 。 

e button: 主要 用 于 图 标 大 小 要 求 不 高 ， 间 隔 要 求 也 不 高 的 场合 。 

e background: 主要 用 于 能 够 以 较 大 空间 显示 图 标的 场合 。 

e drawableLeft: 主要 用 于 对 图 标 与 文字 之 间 的 间隔 有 要 求 的 场合 。 


3.3” 适 配 视 图 基础 


本 节 介 绍 适 配器 的 基本 概念 ， 结 合 对 下 拉 框 Spinner 的 使 用 说 明 分 别 阐述 数组 适配器 
ArrayAdapter、 简 单 适 配器 SimpleAdapter 的 具体 用 法 与 展示 效果 。 


3.3.1 下 拉 框 Spinner 


Spinner 是 下 拉 框 ， 用 于 从 一 串 列 表 中 选择 某 项 ， 功 能 类 似 于 单 选 按钮 的 组 合 。 下 拉 列 表 
的 展示 方式 有 两 种 ， 一 种 是 在 当前 下 拉 框 的 正 下 方 展示 列表 ， 此 时 把 spinnerMode 属性 设置 为 
dropdown; 另 一 种 是 在 页 面 中 部 以 对 话 框 形式 展示 列表 ， 此 时 把 spinnerMode 属性 设置 为 
dialog. F, Spinner 还 可 以 在 代码 中 调用 下 列 4 个 方法 。 
setPrompt: 设置 标题 文字 。 
setAdapter: 设置 下 拉 列 表 的 适配器 。 适 配器 可 选择 ArrayAdapter 或 SimpleAdapter。 
setSelection: 设置 当前 选中 哪 项 。 注 意 该 方法 要 在 setAdapter 方法 后 调用 。 
setOnItemSelectedListener: 设置 下 拉 列 表 的 选中 监听 器 ， 该 监听 器 要 实现 接口 
OnltemSelectedListener. 


下 面 是 一 个 自 定义 选中 监听 器 的 例子 : 
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private String[] starArray = {" 水 星 ", "金星 ", "地 球 ", "火星 ", "木星 ", "土星 "}; 
private class MySelectedListener implements OnItemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) í 
Toast.makeText(SpinnerDialogActivity.this, "您 选择 的 是 "+starArray[arg2]， 
Toast.LENGTH LONG).show(); 
; 


public void onNothingSelected(AdapterView-?- arg0) í 
$ 
| 


下 面 是 使 用 Spinner 控件 的 代码 片段 : 


ArrayAdapter<String> starAdapter = new ArrayAdapter<String>(this, 
R.layout.item select, starArray); 

starAdapter.setDropDownViewResource(R.layout.item dropdown); 

Spinner sp = (Spinner) findViewById(R.id.sp dialog); 

sp.setPrompt(" 请 选择 行星 "); 

sp.setAdapter(starAdapter); 

sp.setSelection(0); 

sp.setOnltemSelectedListener(new MySelectedListener()); 


接 下 来 看 对 话 框 模式 的 下 拉 效 果 ， 如 图 3-11 所 示 。 页 面 中 部 弹出 六 大 行星 的 下 拉 列 表 ; 
点 击 具体 行星 项 后 自动 收 起 下 拉 列 表 ， 并 且 下 拉 框 中 的 文字 变更 为 刚 选中 的 行星 名 称 。 





图 3-11 dialog 模式 的 下 拉 列表 
3.3.2 ”数组 适配器 ArrayAdapter 


前 面 在 演示 Spinner 时 用 到 了 setAdapter 方法 设置 适配器 。 这 个 适配器 好 比 一 组 数据 的 加 
工 流水 线 ， 你 丢 给 它 一 大 把 糖果 ， 适 配器 把 糖果 排列 好 顺序 ， 然 后 拿 来 制作 好 的 包装 盒 ， 把 糖 
果 往 里 面 一 塞 , 出 来 的 便 是 一 个 个 精美 的 糖果 盒 。 这 个 流水 线 可 以 做 得 很 复杂 ， 也 可 以 做 得 简 
单一 些 ， 最 简单 的 流水 线 就 是 之 前 演示 Spinner 用 到 的 ArrayAdapter。 
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ArrayAdapter 主要 用 于 每 行列 表 只 展示 文本 的 情况 , 有 两 道 工序 , 第 一 道 工序 是 构造 函数 ， 
除了 提供 一 堆 原始 数据 外 〈 六 大 行星 的 名 称 列表 ) ， 还 可 以 指定 下 拉 框 当前 文本 的 包装 盒 ， 即 
下 面 这 行 代码 里 的 R.layout.item_select， 这 个 布局 文件 内 只 有 一 个 TextView， 定 义 了 当前 选中 
文本 的 大 小 、 颜 色 、 对 齐 方式 等 属性 。 

ArrayAdapter-String- starAdapter = new ArrayAdapter<String>(this, 
R.layout.item_select, starArray); 

第 二 道 工序 是 定义 下 拉 列 表 的 包装 盒 ， 即 下 面 代 码 里 的 R.layoutitem dropdown, jÉ X f 
对 话 框 列表 中 每 行文 本 的 显示 属性 。 

starAdapter.setDropDownViewResource(R.layout.item dropdown); 


经 过 这 两 道 工序 ，ArrayAdapter 就 明确 了 原料 糖果 的 分 拣 过 程 与 包装 方式 ， 接 下 来 只 条 
Spinner 调用 setAdapter 方法 发 出 开动 机 器 指令 , 适配器 便 会 把 一 个 一 个 糖果 盒 输出 到 屏幕 界面 。 


3.3.3 简单 适配器 SimpleAdapter 


ArrayAdapter 只 能 显示 文本 列表 ， 显 然 不 够 美观 ， 有 时 我 们 还 想 给 列表 加 上 图 标 ， 比 如 六 
大 行星 是 否 分 别 显 示 星 球 的 小 图 。 这 时 SimpleAdapter 就 派 上 用 场 了 ， 它 允许 在 列表 项 中 展示 
多 个 控件 ， 包 括 文本 与 图 片 。 

SimpleAdapter 的 实现 略微 复杂 ， 除 了 第 二 道 工序 与 ArrayAdapter 一 样 外 ， 第 一 道 工序 需 
要 更 多 信息 。 例如, 原料 不 但 有 糖果 ,还 有 贺卡 ， 这 样 就 得 把 一 大 袋 糖果 和 一 大 袋 贺卡 送 进 流 
水 线 ， 适 配器 每 次 拿 一 颗 糖 果 和 一 张 贺 卡 ， 把 糖果 与 贺卡 按 规 定 塞 进 包装 盒 。 对 于 
SimpleAdapter 的 构造 函数 来 说 ， 第 二 个 参数 Map 容器 放 的 是 原料 糖果 与 贺卡 ， 第 3 个 参数 放 
的 是 包装 盒 , 第 4 个 参数 放 的 是 糖果 袋 与 贺卡 袋 的 名 称 , 第 5 个 参数 放 的 是 包装 盒 里 塞 糖 果 的 
位 置 与 塞 贺 卡 的 位 置 。 

下 面 是 使 用 SimpleAdapter 的 示例 代码 : 


int[] iconArray = {R.drawable.shuixing, R.drawable.jinxing, R.drawable.diqiu, 
R.drawable.huoxing, R.drawable.muxing, R.drawable.tuxing }; 
List<Map<String, Object>> list = new ArrayList<Map<String, Object>>(); 
for (int i = 0; i < iconArray.length; i++) { 
Map<String, Object» item = new Hash Map<String, Object>(); 
item.put("icon", iconArray[i]); 
item.put("name", starArray[i]); 
list.add(item); 
; 
SimpleAdapter starAdapter = new SimpleA dapter(this, list, R.layout.item select, 
new String[] { "icon", "name" }, new int[] í R.id.iv icon, R.id.tv name }); 
starAdapter.setDropDownViewResource(R.layout.item simple); 


下 面 是 每 个 列表 项 的 布局 文件 代码 〈 包 装 盒 ) : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
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android:layout height-"wrap content" 
android:orientation-"horizontal" > 


*I[mageView 
android:id-"(g)*id/iv icon" 
android:layout width-"Odp" 
android:layout height-"50dp" 
android:layout weight-"1" 
android:gravity-"center" /> 


«TextView 
android:id-"(a)*id/tv name" 
android:layout. width="0dp" 
android:layout height-"match parent" 
android:layout weight-"3" 
android:gravity-"center" 
android:textSize-"17sp" 
android:textColor-" 10000" > 
*/LinearLayout^ 


敲 了 这 么 多 代码 ， 下 面 看 一 下 加 了 图 标的 下 拉 列 表 的 效果 图 ， 如 图 3-12 所 示 。 此 时 下 拉 
列表 左边 显示 行星 的 图 片 ， 右 边 显示 行星 的 名 称 。 





图 3-12 带 图 标的 下 拉 列 表 


3.4 编辑 框 


本 节 介 绍 Android 的 两 种 编辑 框 ， 分 别 是 文本 编辑 框 EditText 与 自动 完成 编辑 框 
AutoCompleteTextView。 在 介绍 EditText 控件 时 ， 除 了 基本 属性 和 方法 ,还 另外 阐述 了 常见 的 
4 种 编辑 处 理 : 更 换 光 标 、 更 换 边框 、 自 动 隐藏 输 入 法 和 输入 回 车 符 自动 换行 。 
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3.4.1 文本 编辑 框 EditText 
EditText 是 文本 编辑 框 ， 用 户 可 在 此 输入 文本 等 信息 。EditText 的 常用 属性 说 明 如 下 。 
e inputType: 指定 输入 的 文本 类 型 ， 代 码 中 对 应 的 方法 是 setInputType。 输 入 类 型 的 取 值 
说 明 见 表 3-3， 若 同时 使 用 多 种 文本 类 型 ， 则 可 使 用 竖 线 “|” 把 多 种 文本 类 型 拼接 起 来 。 
e maxLength: 指定 文本 允许 输入 的 最 大 长 度 。 该 属性 无 法 通过 代码 设置 。 
e hint: 指定 提示 文本 的 内 容 ， 代 码 中 对 应 的 方法 是 setHint。 
e textColorHint: 指定 提示 文本 的 颜色 ， 代 码 中 对 应 的 方法 是 setHintTextColor。 


表 3-3 ”输入 类 型 的 取 值 说 明 

















输入 类 型 说 明 

text 文本 

textPassword 文本 密码 。 显 示 时 用 星 号 “* ”代替 

number 整 型 数 

numberSigned 带 符号 的 数字 。 人 允许 在 开头 带 负 号 “一 ” 

numberDecimal 带 小 数 点 的 数字 

numberPassword 数字 密码 。 显 示 时 用 星 号 “* ”代替 

datetime 时 间 日 期 格式 。 除 了 数字 外 ， 还 允许 输入 横 线 、 斜 杆 、 空 格 、 冒 号 
date 日 期 格式 。 除 了 数字 外 ， 还 允许 输入 横 线 “-” 和 斜 杆 “/” 

time 时 间 格 式 。 除 了 数字 外 ， 还 允许 输入 冒号 “:” 





编辑 框 除 了 上 述 文本 与 提示 文本 的 基本 操作 外 ， 实 际 开发 中 还 常常 关注 4 个 方面 : 更 换 
编辑 框 的 光标 、 更 换 编辑 框 的 边框 、 自 动 隐藏 输 入 法 、 输 入 回 车 符 自动 跳 转 。 

1. 更 换 编 辑 框 的 光标 

EditText 与 光标 处 理 有 关 的 属性 主要 有 两 个 ， 分 别 是 : 

e ”cursorVisible， 指 定 光 标 是 否 可 见 。 代 码 中 对 应 的 方法 是 setCursorVisible。 

etextCursorDrawable， 指 定 光标 的 图 像 。 该 属性 无 法 通过 代码 设置 。 

如 果 要 隐藏 光标 ， 就 要 把 cursorVisible 设置 为 false。 如 果 要 变更 光标 的 样式 ， 就 要 修改 
textCursorDrawable 设置 新 图 像 。 如 图 3-13 所 示 ， 光 标 被 换 成 自 定义 的 红色 竖 线 光 标 。 


2. 更 换 编辑 框 的 边框 


EditText 的 边框 通过 background 属性 控制 ， 如 果 要 隐藏 边框 ， 就 要 把 background 设置 为 
@null; 如 果 要 修改 边框 的 样式 ， 就 要 将 background 设置 为 其 他 边框 图 形 。 
下 面 是 一 个 边框 定义 XML 的 例子 ， 一 旦 编辑 框 获得 焦点 〈 例 如 用 户 点 击 了 该 编辑 框 ) ， 
边框 就 会 显示 图 形 shape edit focus: 否则 默认 显示 shape edit normal. 
«selector xmlns:android="http://schemas.android.com/apk/res/android"> 
«item android:state focused-"true" android:drawable="@drawable/shape_edit_focus"/> 
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<item android:drawable="(@drawable/shape_edit normal"/> 
</selector> 
上 述 自 定义 边框 的 效果 如 图 3-14 所 示 ， 未 点 击 时 显示 灰色 的 圆 角 边框 ， 点 击 后 显示 蓝 色 
的 圆 角 边框 。 




















这 是 默认 光标 





我 的 光标 不 见 了 


E 的 光标 变 红 了 
图 3-13 £i EditText 更 换 图 标 样式 图 3-14 给 EditText 更换 边框 样式 
3. 自动 隐藏 输入 法 


如 果 页 面 上 有 EditText 控件 ， 开 发 者 又 没 做 其 他 处 理 ， 那 么 用 户 打开 该 页 面 时 往往 会 自 
动弹 出 输入 法 。 这 是 因为 编辑 框 会 默认 获得 焦点 ， 即 默认 模拟 用 户 的 点 击 操 作 ， 于 是 输入 法 的 
软 键盘 就 弹出 了 。 要 想 避 免 这 种 情况 ,就 得 阻止 编辑 框 默认 获得 焦点 。 比 较 常 见 的 做 法 是 给 该 
页 面 的 根 节点 设置 focusable 和 focusableInTouchMode 属性 ， 通 过 将 这 两 个 属性 设置 为 true 可 
强制 让 根 节点 获得 焦点 ， 从 而 避免 输入 法 自动 弹出 的 尴 傣 。 

由 于 软 键盘 通常 会 遮盖 “登录 ”“ 确 认 ”“ 下 一 步 ” 等 按钮 ， 造 成 用 户 输入 完毕 得 再 点 

-次 返回 键 才能 关闭 软 键盘 。 大 家 都 希望 省 事 点 ， 比 如 手机 号 输入 满 11 位 软 键盘 自动 关闭 ， 
这 样 就 会 极 大 改善 用 户 体验 。 一 个 好 用 的 App 就 是 在 这 一 点 一 滴 中 体现 出 来 的 。 

想 让 编辑 框 文本 达到 指定 长 度 时 自动 关闭 输入 法 ， 开 发 者 需要 获得 两 个 参数 ， 第 一 个 是 
该 编辑 框 允许 输入 的 最 大 长 度 , 第 二 个 是 当前 已 经 输入 的 文本 长 度 。 当 已 输入 的 文本 长 度 等 于 
最 大 长 度 时 ， 即 可 触发 关闭 软 键盘 。 自 动 隐藏 输入 法 可 分 解 为 3 个 功能 点 , 分 别 是 获取 编辑 框 
的 最 大 长 度 、 监 控 当 前 已 输入 的 文本 长 度 和 关闭 软 键盘 。 


(1) 获取 编辑 框 的 最 大 长 度 
前 面 我 们 了 解 到 maxLength 属性 可 设置 最 大 长 度 ， 但 是 EditText 并 没有 提供 获取 最 大 长 
度 的 方法 ， 不 过 我 们 可 以 通过 反射 方式 曲线 获得 最 大 长 度 ， 具 体 代码 如 下 : 


public static int get MaxLength(EditText et) { 
int length = 0; 
ty { 
InputFilter[] inputFilters = et.getFilters(); 
for (InputFilter filter : inputFilters) í 
Class<?> c = filter.getClass(); 
if (c.getName().equals("android.text.InputFilter$LengthFilter")) í 
Field[] f = c.getDeclaredFields(); 
for (Field field : f) í 
if (field.getName().equals("mMax")) í 
field.setAccessible(true); 
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length = (Integer) field.get(filter); 


; 
; 
} catch (Exception e) í 
e.printStackTrace(); 


; 
return length; 
} 


(2) 监控 当前 已 输入 的 文本 长 度 
这 个 监控 操作 用 到 一 个 文本 监听 器 接口 TextWatcher， 该 接口 提供 了 3 个 监控 方法 ， 有 具体 
说 明 如 下 。 


* beforeTextChanged: 在 文本 改变 之 前 触发 。 
* onTextChanged: 在 文本 改变 过 程 中 触发 。 
© afterTextChanged: 在 文本 改变 之 后 触发 。 


这 里 用 到 的 是 afterTextChanged 方法 ,开发 者 需要 自己 写 个 监听 器 实现 TextWatcher 接口 ， 
另外 再 给 EditText 对 象 调用 addTextChangedListener 方法 注册 该 监听 器 。 下 面 是 一 个 具体 实现 
该 监听 器 的 例子 : 

private class HideTextWatcher implements TextWatcher í 
private EditText mView; 
private int mMaxLength; 
private CharSequence mStr; 


public HideTextWatcher(EditText v) í 

super(); 

mView = v; 

mMaxLength = ViewUtil.getMaxLength(v); 
li 


@Override 
public void beforeTextChanged(CharSequence s, int start, int count, int after) { 
; 


(aOverride 

public void onTextChanged(CharSequence s, int start, int before, int count) ( 
mStr = s; 

; 
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(@Override 
public void afterTextChanged(Editable s) í 
if (mStr = null || mStr.length() = 0) 
return; 
if (mStr.length() = 11 && mMaxLength = 11) í 
ViewUtil.hideAllInputMethod(EditHideActivity.this); 
} else if (mStr.length() = 6 && mMaxLength = 6) í 
ViewUtil.hideOneInputMethod(EditHideActivity.this, m View); 
I. 


1 


(3) 关闭 软 键盘 
输入 法 通过 系统 服务 INPUT. METHOD SERVICE 管理 , 所 以 隐藏 输入 法 也 要 通过 该 服务 
实现 。 下 面 是 关闭 软 键盘 的 两 种 方式 及 其 代码 : 
© 调用 toggleSoftInput 方法 : 
public static void hideAllInput Method(Activity act) í 
InputMethodManager imm = (InputMethodManager) 
act.getSystemService(Context.INPUT METHOD SERVICE); 
if (imm.isActive() = true) { // 软 键盘 如 果 已 经 打开 就 要 关闭 
imm.toggleSoftInput(0, InputMethodManager.HIDE NOT. ALWAYS); 
D 
1 


@ 调用 hideSoftInputFromWindow 方法 : 
public static void hideOneInputMethod(Activity act, View v) í 
InputMethodManager imm = (InputMethodManager) 
act.getSystemService(Context.]INPUT METHOD SERVICE); 


imm.hideSoftInputFromWindow(v.getWindow Token(), 0); 
} 


完成 隐藏 输入 法 的 编码 后 ， 可 在 页 面 上 观察 效果 ， 如 图 3-15 所 示 。 此 时 手机 号 码 输入 了 
10 位 ， 还 没 达 到 11 位 的 最 大 长 度 ， 故 而 输入 法 依然 显示 。 手 机 号 再 输入 一 位 数字 , 总 长 度 M 
位 达到 最 大 长 度 的 限制 ， 于 是 输入 法 自动 隐藏 ， 如 图 3-16 所 示 。 


4. 输入 回 车 符 自动 跳 转 
在 录入 用 户 信息 时 《比如 输入 姓名 、 密 码 等 ) ， 往 EditText 控件 输入 回 车 键 ， 常 常 不 是 
换行 而 是 让 光标 直接 跳 到 下 一 个 编辑 框 。 该 功能 用 到 了 文本 监听 器 接口 TextWatcher， 主 要 监 


听 用 户 是 否 输入 回 车 符 ， 如 果 监 控 到 已 输入 回 车 符 ， 就 自动 将 焦点 移 到 下 一 个 控件 ， 从 而 实现 
回 车 符 自动 跳 转 的 要 求 。 
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1596023869 


15960238698 





输入 6 位 时 自动 














图 3-15 输入 10 位 手机 号 码 图 3-16 输入 11 位 手机 号 码 
下 面 是 回 车 符 监听 器 的 代码 ， 注 意 注释 部 分 的 文字 说 明 : 


private class JumpTextWatcher implements TextWatcher í 
private EditText mThisView = null; 





private View mNextView = null; 


public JumpTextWatcher(EditText vThis, View vNext) í 
super(); 
mThisView = vThis; 
if (vNext != null) í 
mNextView — vNext; 


@Override 
public void beforeTextChanged(CharSequence s, int start, int count, int after) { 
$ 


@Override 
public void onTextChanged(CharSequence s, int start, int before, int count) { 
; 


(GOverride 
public void afterTextChanged(Editable s) í 

String str — s.toString(); 

if (strindexOf(" v") >= 0 || strindexOf("n") >=0) (.— /发 现 输入 回 车 符 或 换行 符 
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mThisView.setText(str.replace("\r", "").replace("\n", "")); /去 掉 回 车 符 和 换行 符 
if (mNextView != null) í 
mNextView.requestFocus(); Vi 下 一 个 视图 获得 焦点 ， 即 将 光标 移 到 下 个 视图 
if (mNextView instanceof EditText) í 
EditText et = (EditText)mNextView; 
/让 光标 自动 移 到 编辑 框 内 部 的 文本 末尾 
/方式 一 : 直接 调用 EditText 的 setSelection 方法 
et.setSelection(et.getText().length()); 
/方式 二 : 调用 Selection 类 的 setSelection 方法 
//Editable edit = et.getText(); 
//Selection.setSelection(edit, edit.length()); 


} 
下 面 演示 一 下 输入 回 车 符 自动 跳 转 的 效果 图 ， 文 本 输入 完毕 后 还 没 输入 回 车 符 ， 此 时 焦 
点 仍然 停留 在 编辑 框 ， 如 图 3-17 所 示 。 输 入 回 车 符 ， 此 时 焦点 离开 编辑 框 ， 并 自动 移动 到 “ 登 
录 ” 按 钮 〈 编 辑 框 的 光标 消失 ， 按 钮 背景 变 深 ) ， 如 图 3-18 所 示 。 


Middle Middle 





图 3-17 未 按 回 车 符 图 3-18 已 按 回 车 符 
342 ”自动 完成 编辑 框 AutoCompleteTextView 


自动 完成 编辑 框 一 般 用 于 搜索 文本 框 ， 如 在 电 商 App 的 搜索 框 输入 商品 文字 时 ， 下 方 会 
自动 弹出 提示 词 列 表 ， 方 便 用 户 快速 选择 具体 商品 。AutoCompleteTextView 的 实现 原理 是 : 
EditText 结合 监听 器 TextWatcher 与 下 拉 列 表 Spinner， 一 旦 监控 到 EditText 的 文本 发 生变 化 ， 
就 自动 弹出 适 配 好 的 文字 下 拉 列 表 ， 选 中 具体 的 下 拉 项 向 EditText 填 入 相应 文字 。 

AutoCompleteTextView 新 增 的 几 个 属性 都 与 下 拉 列 表 有 关 ， 详 细 说 明 见 表 3-4。 


表 3-4 自动 完成 编辑 框 的 属性 和 设置 方法 说 明 
XML 中 的 属性 AutoCompleteTextView 类 的 设置 方法 | 说 明 
completionHint setCompletionHint 设置 下 拉 列 表 底 部 的 提示 文字 
completionThreshold setThreshold 设置 至 少 输入 多 少 个 字符 才 会 显示 提示 
dropDownHorizontalOffset | setDropDownHorizontalOffset 设置 下 拉 列 表 与 文本 框 之 间 的 水 平 偏 移 
dropDownVerticalOffset setDropDownVerticalOffset 设置 下 拉 列 表 与 文本 框 之 间 的 垂直 偏 移 
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ESO 
XML 中 的 属性 AutoCompleteTextView 类 的 设置 方法 | 说 明 
dropDownHeight setDropDownHeight 设置 下 拉 列表 的 高 度 
dropDownWidth setDropDownWidth 设置 下 拉 列 表 的 宽度 
无 SetAdapter 设置 下 拉 列 表 的 数据 适配器 








下 面 是 使 用 AutoCompleteTextView 的 代码 : 
String[] hintAmay = {" 第 一 ", "第 一 次 " "第 一 次 写 代码 " "第 一 次 领 工资 " "第 二 ", "第 二 个 "); 
ArrayAdapter<String> adapter= new ArrayAdapter<String>( 
this, R.layout.item_dropdown, hintArray); 
AutoCompleteTextView ac text- (AutoCompleteTextView) findViewByld(R.id.ac text); 
ac text.setAdapter(adapter); 


自动 完成 编辑 框 的 具体 效果 如 图 3-19 所 示 ， 下 拉 列 表 的 内 容 会 自动 与 编辑 框 的 文本 进行 
匹配 。 








第 一 
第 一 次 

第 一 次 写 代码 

第 一 次 领 工资 











图 3-19 ”自动 完成 编辑 框 的 自动 匹配 下 拉 列 表 


3.5 Activity 基础 


本 节 介 绍 Android 四 大 组 件 之 一 Activity 的 基本 概念 和 常见 用 法 。 首 先 说 明 Activity 的 生 
命 周期 ， 接 着 说 明 Intent 的 组 成 部 分 与 工作 原理 ， 然 后 阐述 如 何 使 用 Intent 完成 活动 页 面 之 间 
的 消息 传递 ， 包 括 如 何 传递 请 求 参数 、 如 何 返 回应 答 参 数 等 。 
3.5.1 Activity 的 生命 周期 

看 到 这 里 ， 相 信 读 者 对 Activity 已 经 不 陌生 了 。 首 先 ， 一 个 Activity 代表 一 个 页 面 。 其 次 ， 
Activity 的 onCreate 方法 是 页 面 的 入 口 函 数 。 更 细心 的 读者 也 许 已 经 知道 调用 startActivity 方 
法 可 以 跳 转 到 下 一 个 页 面 。 之 所 以 到 这 时 才 介 绍 Activity， 是 因为 Activity 的 逻辑 复杂 、 概 念 
繁多 ， 必 须 在 有 一 定 基础 后 讲解 才 合适 ， 不 然 一 开始 就 讲解 高 深 的 专业 术语 ， 读 者 恐怕 很 难 
理解 。 
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首先 介绍 Activity 的 生命 周期 ， 如 同 花 开花 落 一 般 ，Activity 也 有 从 含苞 待 放 到 盛 
凋零 的 生命 过 程 。 下 面 是 Activity 与 生命 周期 有 关 的 方法 说 明 。 


onCreate: 创建 页 面 。 把 页 面 上 的 各 个 元 素 加 载 到 内 存 中 。 


onStart: 开始 页 面 。 把 页 面 显 示 在 屏幕 上 。 








onResume: 恢复 页 面 。 让 页 面 在 屏幕 上 活动 起 来 ， 例 如 开启 动画 、 开 始 任务 等 。 


onPause: 暂停 页 面 。 让 页 面 在 屏幕 上 的 动作 停 下 来 。 


onStop: 停止 页 面 。 把 页 面 从 屏幕 上 撤 下 来 。 


onDestroy: 销毁 页 面 。 把 页 面 从 内 存 中 清除 掉 。 
onRestart: 重启 页 面 。 重 新 加 载 内 存 中 的 页 面 数据 。 








再 到 


下 面 针对 几 个 常见 的 业务 场景 探究 一 下 Activity 的 生命 周期 ， 主 要 有 3 个 场景 : 页 面 之 间 
的 跳 转 、 竖 屏 与 横 屏 的 切换 、 按 HOME 键 与 返回 App。 用 于 场景 测试 的 代码 如 下 ， 主 要 在 每 
个 生命 周期 函数 中 增加 打印 屏幕 日 志和 后 台 日 志 。 


private void refreshLife(String desc) í 
Log.d(TAG, desc); 


mStr = String.format("%s%s %s os", mStr, DateUtil.getNowTimeDetail(), TAG, desc); 


tv life.setText(mStr); 
1 


@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity act ***); 
tv. life = (TextView) findViewById(R.id.tv life); 
refreshLife("onCreate"); 

h 


@Override 

protected void onStart() { 
refreshLife("onStart"); 
super.onStart(); 

j 


@Override 

protected void onStop() í 
refreshLife("onStop"); 
super.onStop(); 

h: 


@Override 
protected void onResume() { 
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refreshLife("onResume"); 
super.onResume(); 


(@Override 

protected void onPause() í 
refreshLife("onPause"); 
super.onPause(); 


@Override 

protected void onRestart() { 
refreshLife("onRestart"); 
super.onRestart(); 


(a Override 

protected void onDestroy() í 
refreshLife("onDestroy"); 
super.onDestroy(); 

j 


1. 页 面 之 间 的 跳 转 


首先 进入 测试 页 面 AcUumpActivity, 接着 从 该 
页 面 跳 转 到 ActNextActivity ， 然 后 从 
ActNextActivity 返回 ActJumpActivity。 界面 上 的 日 





Middle 


跳 到 下 个 页 面 
20:30:20.916 ActJumpActivity onCreate 


16 ActJumpActivity onResume 





志 截 图 如 图 3-20 所 示 。 其 中 ， 区 域 1 表示 进入 页 
面 ActJumpActivity 时 的 生命 周期 过 程 ， 区 域 2 表 
示 跳 转 到 ActNextActivity 时 的 生命 周期 过 程 , 区 域 
3 表示 返回 ActJumpActivity 时 的 生命 周期 过 程 。 

从 日 志 截 图 可 以 看 到 , 下 一 个 页 面 的 创建 伴随 
上 一 个 页 面 的 停止 ， 不 过 显示 的 日 志 信息 不 够 完 
整 。 下 面 我 们 跟踪 一 下 logcat 里 的 日 志 , 看 看 这 中 
间 到 底 发 生 了 什么 。 








2.524 ActJumpActivity onPause 
2.972 ActJumpActivity onStop 
20:30:40.657 ActJumpaActivity 
20:30:22.568 ActNextActivity onCreate 
20:30:22.568 ActNextA: ity onStart 
20:30:22.568 ActNextActivity onResume 


20:30:40.661 ActJumpaActivity onActivityResult 
20:30:40.661 ActJumpActivity onRestart 
20:30:40.661 ActJumpaActivity onStart 
20:30:40.661 ActJumpActivity onResume 


图 3-20 活动 页 面 跳 转 时 的 界面 日 志 截 图 


首先 打开 页 面 ActJumpActivity, 调用 方法 的 顺序 为 :本 页 面 onCreate— onStart--onResume, 


日 志 如 下 : 


11:30:18.352: D/ActJumpActivity(2315): onCreate 
11:30:18.352: D/ActJumpActivity(2315): onStart 
11:30:18.352: D/ActJumpActivity(2315): onResume 


从 ActJumpActivity 跳 转 到 ActNextActivity， 调 用 方法 的 顺序 为 : 上 一 个 页 面 onPause 一 下 
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一 个 页 面 onCreate 一 onStart 一 onResume 一 上 一 个 页 面 onStop。 日 志 如 下 : 


11:30:32.668: D/ActJumpActivity(2315): onPause 
11:30:32.688: D/ActNextActivity(2315): onCreate 
11:30:32.688: D/ActNextActivity(2315): onStart 
11:30:32.688: D/ActNextActivity(2315): onResume 
11:30:33.116: D/ActJumpActivity(2315): onStop 


从 ActNextActivity EIF] AcJumpActivity 〈 按 返回 键 或 在 代码 中 调用 finish 方法 ) ， 调 用 
的 方法 顺序 为 : 下 一 个 页 面 onPause 一 上 一 个 页 面 onRestart 一 onStart 一 onResume 一 下 一 个 页 面 
onStop 一 onDestroy。 日 志 如 下 : 


11:30:40.740: D/ActNextActivity(2315): onPause 
11:30:40.752: D/ActJumpActivity(2315): onRestart 
11:30:40.752: D/ActJumpActivity(2315): onStart 
11:30:40.752: D/ActJumpActivity(2315): onResume 
11:30:41.160: D/ActNextActivity(2315): onStop 
11:30:41.164: D/ActNextActivity(2315): onDestroy 


至 此 ,基本 上 可 以 弄 清楚 页 面 跳 转 时 的 生命 
周期 了 。 总 体 上 是 跳 转 前 的 页 面 先 调用 onPause 


方法 ， 然 后 跳 转 后 的 页 面 依次 调用 :34:11.106 ActRotateActivity onCreate 
a .106 ActRotateActivity onStart 
onCreate/onRestart 一 onStart 一 onResume， 最 后 跳 34: "loe ACARANE onnesame 


转 前 的 页 面 调用 onStop 方法 〈 若 返回 上 级 页 面 ， 
则 下 级 页 面 还 需 调用 onDestroy 方法 ) 。 


20:36:24.558 ActRotateActivity onCreate 
558 ActRotateActivity onStart 


2. 坚 屏 与 横 屏 的 切换 .558 ActRotateActivity onResume 
首先 进入 测试 页 面 ActRotateActivity， 此 时 
默认 为 竖 屏 显示 ; 接着 倒转 手机 切换 到 横 屏 ， 观 140:11/632 an Oncreats 
RHE: 然后 倒转 手机 切换 回 竖 屏 ， 观 察 日 志 。 Oe A 


:11.640 ActRotateActivity onResume 





3 个 屏幕 的 显示 日 志 时 间 没有 重复 ， 这 里 的 日 志 
截图 是 3 次 截图 拼接 而 成 的 ， 如 图 3-21 所 示 。 — 图 321 活动 页 面 在 横竖 屏 切换 时 的 界面 日 志 截图 

从 日 志 截 图 可 以 看 出 ， 竖 屏 与 横 屏 似乎 在 每 次 切换 时 页 面 都 要 重新 创建 。 为 进一步 验证 
实验 结果 ， 再 一 次 查看 logcat 里 的 日 志 ， 日 志 信息 如 下 : 


21:02:10.179 D/ActRotateActivity: onCreate 
21:02:10.179 D/ActRotateActivity: onStart 
21:02:10.179 D/ActRotateActivity: onResume 
21:02:13.227 D/ActRotateActivity: onPause 
21:02:13.227 D/ActRotateActivity: onStop 
21:02:13.227 D/ActRotateActivity: onDestroy 
21:02:13.247 D/ActRotateActivity: onCreate 
21:02:13.247 D/ActRotateActivity: onStart 
21:02:13.247 D/ActRotateActivity: onResume 
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21:02:16.239 D/ActRotateActivity: onPause 
21:02:16.239 D/ActRotateActivity: onStop 
21:02:16.239 D/ActRotateActivity: onDestroy 
21:02:16.279 D/ActRotateActivity: onCreate 
21:02:16.279 D/ActRotateActivity: onStart 
21:02:16.279 D/ActRotateActivity: onResume 


分 析 日 志 的 时 间 与 内 容 ， 无 论 是 竖 屏 切换 到 横 屏 ， 还 是 横 屏 切换 到 竖 屏 ， 都 是 原 屏幕 的 
页 面 从 onPause 到 onStop 再 到 onDestroy 一 路 销毁 ， 然 后 新 屏幕 的 页 面 从 onCreate 到 onStart 
再 到 onResume 一 路 创建 而 来 。 


3. 按 HOME 键 与 返回 App 


首先 进入 测试 页 面 ActHomeActivity; 接着 按 
HOME 键 ， 屏 幕 回 到 桌面 ， 然 后 按 任 务 键 或 长 按 MN 
HOME 键 (不 同 手机 的 操作 不 一 样 ) ,屏幕 调 出 进 ”| ,o:27:42.586 ActHomeActivity onCreate 
S i a 


-路 下 来 的 屏 幕 ] 志 截 图 如 图 3-22 所 示 " 20:27:47.538 ActHomeActivity onPause 


20:27:47.690 ActHomeActivity onStop 
APRETAR MAMAN EA e AA S ond 
期 是 典型 的 从 活动 状态 变 为 暂停 状态 〈 回 到 桌面 20:27:51.682 ActHomeActivity onResume 
WE) 再 到 活动 状态 (返回 App 页 面 时 ) 。 观 察 logcat 
的 后 台 日 志 ， 发 现 后 台 日 志 与 屏幕 日 志保 持 一 致 


35.2 ”使 用 Intent 传递 消息 


Intent 的 中 文 名 是 意图 ， 意 思 是 我 想 让 你 干什么 ， 简 单 地 说 ， 就 是 传递 消息 。Intent 是 各 

个 组 件 之 间 信 息 沟 通 的 桥梁 ， 既 能 在 Activity 之 间 沟 通 ， 又 能 在 Activity 与 Service 之 间 沟 通 ， 
也 能 在 Activity 与 Broadcast 之 间 沟 通 。 总 而 言 之 , Intent 用 于 处 理 Android 各 组 件 之 间 的 通信 ， 
完成 的 工作 主要 有 3 部 分 : 

CD Intent 需 标 明 本 次 通信 请 求 从 哪里 来 、 到 哪里 去 、 要 怎么 走 。 

(2) 发 起 方 携带 本 次 通信 需要 的 数据 内 容 ， 接 收 方 对 收 到 的 Intent 数据 进行 解 包 。 

(3) 如 果 发 起 方 要 求 判断 接收 方 的 处 理 结果 ，Intent 就 要 负责 让 接收 方 传 回应 答 的 数据 
内 容 。 










图 3-22 dE HOME 键 的 界面 日 志 截 图 














为 了 做 好 以 上 工作 ， 就 要 给 Intent 配 上 必须 的 装备 ，Intent 的 组 成 部 分 见 表 3-5。 
表 3-5 Intent 组 成 元 素 的 列表 说 明 











说 明 与 用 途 
组 件 ， 用 于 指定 Intent 的 来 源 与 目的 
动作 ， 用 于 指定 Intent 的 操作 行为 

即 Uri， 用 于 指定 动作 要 操纵 的 数据 路 径 
类 别 ， 用 于 指定 Intent 的 操作 类 别 








Action | setAction 


| setData 








addCategory 
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( 续 表 ) 










设置 方法 
Type setType 
Extras putExtra 


说 明 与 用 途 
数据 类 型 ， 用 于 指定 Data 类 型 的 定义 
扩展 信息 ， 用 于 指定 装载 的 参数 信息 
标志 位 ， 用 于 指定 Intent 的 运行 模式 〈 启 动 标志 ) 


表达 Intent 的 来 往 路 径 有 两 种 方式 ， 一 种 是 显 式 Intent， 另 一 种 是 隐 式 Intent. 
1. 显 式 Intent， 直 接 指定 来 源 类 与 目标 类 名 ， 属 于 精确 匹配 。 
在 声明 一 个 Intent 对 象 时 ， 需 要 指定 两 个 参数 ， 第 一 个 参数 表示 跳 转 的 来 源 页 面 ， 第 二 个 
参数 表示 接 下 来 要 跳 转 到 的 页 面 类 。 有 具体 的 声明 方式 有 如 下 3 fb: 
CD 在 构造 函数 中 指定 ， 示 例 代 码 如 下 : 
Intent intent = new Intent(this, ActResponseActivity.class); 
(2) 调用 setClass 方法 指定 ， 示 例 代码 如 下 : 


Intent intent = new Intent(); 




















setFlags 


intent.setClass(this, ActResponseActivity.class); 
(3) 调用 setComponent 方法 指定 ， 示 例 代 码 如 下 : 


Intent intent = new Intent(); 
ComponentName component = new ComponentName(this, ActResponseActivity.class); 
intent.setComponent(component); 


2. 隐 式 Intent, 没有 明确 指定 要 跳 转 的 类 名 , 只 给 出 一 个 动作 让 系统 匹配 拥有 相同 字 串 定义 
的 目标 ， 属 于 模糊 匹配 。 

因为 我 们 常常 不 希望 直接 暴露 源码 的 类 名 ， 只 给 出 一 个 事先 定义 好 的 名 称 ， 这 样 大 家 约 
定 俗 成 、 按 图 索 驴 就 好 ， 所 以 隐 式 Intent 起 到 了 过 滤 作用 。 这 个 定义 好 的 动作 名 称 是 一 个 字符 
串 ， 可 以 是 自己 定义 的 动作 ， 也 可 以 是 已 有 的 系统 动作 。 系 统 动作 的 取 值 说 明 见 表 3-6。 


表 3-6 系统 动作 的 取 值 说 明 


























Intent 类 的 系统 动作 常量 名 系统 动作 的 常量 值 说 明 

ACTION_MAIN android.intent.action.MAIN App 启动 时 的 入 口 

ACTION VIEW android.intent.action. VIEW 显示 数据 给 用 户 

ACTION EDIT android.intent.action.EDIT 显示 可 编辑 的 数据 
ACTION_CALL android.intent.action. CALL 拨号 

ACITON_DIAL android.intent.action.DIAL 打 电 话 

ACTION SEND android.intent.action SEND 发 短信 

ACTION ANSWER android.intent.action ANSWER 接 电 话 

ACTION SEARCH android.intent.action SEARCH 导航 栏 上 Search View 的 搜索 动作 
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这 个 动作 名 称 通过 setAction 方法 指定 , 也 可 以 通过 构造 函数 Intent(String action) 直 接生 成 
Intent 对 象 。 当 然 ， 由 于 动作 是 模糊 匹配 ， 因 此 有 时 需要 更 详细 的 路 径 ， 比 如 知道 某 人 住 在 天 
通 苑 小 区 ， 并 不 能 直接 找到 他 家 ， 还 得 说 明 他 住 在 天 通 苑 的 哪 一 期 、 哪 号 楼 、 哪 一 层 、 哪 一 个 
单元 .Uri 和 Category 便 是 这 样 的 路 径 与 门类 信息 , Uri 数据 可 通过 构造 函数 Intent(String action, 
Uri uri) 在 生成 对 象 时 一 起 指定 ， 也 可 通过 setData 方法 指定 (setData 这 个 名 字 有 歧义 ， 实 际 就 
是 setUri) ; Category 可 通过 addCategory 方法 指定 ， 之 所 以 用 add 而 不 用 set 方 法 ， 是 因为 一 
个 Intent 可 同时 设置 多 个 Category， 一 起 进行 过 滤 。 

下 面 是 一 个 调用 系统 拨号 程序 的 例子 ， 其 中 就 用 到 了 Uri: 

Intent intent = new Intent(); 
intent.setAction(IntenL ACTION CALL); 
Uri uri = Uri.parse("tel:"+" 15960238696"); 
intent.setData(uri); 

startActivity(intent); 

隐 式 Intent 还 用 到 了 过 滤器 的 概念 , 即 把 不 符合 匹配 条 件 的 过 滤 掉 ， 剩 下 符合 条 件 的 按照 
优先 顺序 调用 。 创 建 一 个 Android 工程 ，AndroidManifestxml 里 的 intent-filter 就 是 XML 中 的 
过 滤器 。 比 如 下 面 这 个 最 常见 的 主页 面 MainAcitivity，activity 节点 下 面 便 设置 了 action 和 
category 的 过 滤 条 件 。 其 中 ，android.intent.action.MAIN 表示 App 的 入 口 动 作 ， 
android.intent.category.LAUNCHER 表示 在 App 启动 时 调用 。 








<activity 
android:name=".MainActivity" 
android:label="(@string/app_name" > 
<intent-filter> 
«action android:name="android.intent.action.MAIN" /> 
<category android:name-"android.intent.category.LAUNCHER" /> 
«/intent-filter 
«activity» 


3.5.8 [8 R—^ Activity 传递 参数 


前 面 说 了 ，Intent 的 setData 方法 只 指定 到 达 目 标的 路 径 ， 并 非 本 次 通信 所 携带 的 参数 信 
息 , 真正 的 参数 信息 存放 在 Extras 中 。 Intent 重 载 了 很 多 种 putExtra 方法 传递 各 种 类 型 的 参数 ， 
舌 String. int, double 等 基本 数据 类 型 ， 甚 至 Parcelable、Serializable 等 序列 化 结构 。 不 过 
是 调用 putExtra 方法 显然 不 好 管理 ， 像 送 快递 一 样 大 小 包 庄 随便 扔 ， 不 但 找 起 来 不 方便 ， 丢 
也 难以 知道 。 所 以 Android 引入 了 Bundle 概念 ， 我 们 可 以 把 Bundle 理解 为 超市 的 寄 包 柜 或 
HHE, Ka H Bundle 统一 存 取 ， 方 便 又 安全 。 
Bundle 内 部 用 于 存放 数据 的 实质 结构 是 Map 映射 ， 可 添加 元 素 、 删 除 元 素 ， 还 可 判断 元 
是 否 存在 。 开 发 者 把 Bundle 全 部 打包 好 只 需 调用 一 次 putExtras 方法 ， 把 Bundle 全 部 取出 
也 只 需 调 用 一 次 getExtras 方法 。 

下 面 是 前 一 个 页 面向 后 一 个 页 面 发 送 请 求 数据 的 代码 : 
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Intent intent = new Intent(MainActivity.this, FirstActivity.class); 
Bundle bundle = new Bundle(); 

bundle.putString("name", " 张 三 "); 

bundle.putInt("age", 30); 

bundle.putDouble("height", 170.0f); 

intent.putExtras(bundle); 

startActivity(intent); 


下 面 是 后 一 个 页 面 接收 前 一 个 页 面 请 求 数据 的 代码 : 


Intent intent = getlntent(); 

Bundle bundle = intent.getExtras(); 

String name = bundle.getString("name", ""); 

int age — bundle.getInt("age", 0); 

double height = bundle.getDouble("height", 0.0f); 


3.5.4 ”向 上 一 个 Activity 返回 参数 


如 同一 般 的 通信 一 样 ，Intent 有 时 只 把 请 求 数据 发 送 到 下 一 个 页 面 就 行 有 时 还 要 处 理 下 
-个 页 面 的 应 答 数 据 (通常 发 生 在 下 一 个 页 面 返 回 到 上 一 个 页 面 时 )。 如 果 只 把 请 求 数据 发 送 
到 下 一 个 页 面 ， 前 一 个 页 面 调用 startActivity 方法 就 可 以 ;如 果 还 要 处 理 一 下 个 页 面 的 应 答 数 


据 ， 此 时 就 得 分 多 步 处 理 ， 详 细 步 骤 如 下 : 


ED) 前 一 个 页 面 打 包 好 请 求 数 据 ， 调 用 方法 startActivityForResult(Intent intent, int 
requestCode)， 表 示 需 要 处 理 结果 数据 ， 第 二 个 参数 表示 请 求 编号 ， 用 于 标识 每 次 请 求 的 唯一 性 。 


CE 后 一 个 页 面 接收 请 求 数据 ， 进 行 相应 处 理 。 





Eo 后 一 个 页 面 在 返回 前 一 个 页 面 时 ,打包 应 答 数据 并 调用 setResult 方 法 返 





的 第 一 个 参数 表示 应 答 代码 (成 功 还 是 失败 )， 代 码 示 例如 下 : 


Intent intent = new Intent(); 

Bundle bundle = new Bundle(); 
bundle.putString("job", " 码 农 "); 
intent.putExtras(bundle); 
setResult(Activity. RESULT OK, intent); 
finish(); /表示 关闭 当前 页 面 


回信 息 。setResult 





E 前 一 个 页 面 重 写 方法 onActivityResult, 该 方法 的 输入 参数 包含 请 求 编号 和 应 答 代码 , 请 
求 编号 用 于 判断 对 应 哪 次 请 求 ， 应 答 代码 用 于 判断 后 一 个 页 面 是 否 处 理 成 功 。 然 后 对 应 答 数 据 进行 解 


























包 处 理 ， 代 码 示例 如 下 : 


(@Override 
public void onActivityResult(int requestCode, int resultCode, Intent intent) í 


Log.d(TAG, "onActivityResult. requestCode-"-requestCode-", resultCode-"-resultCode); 


Bundle resp = intent.getExtras(); 
String job — resp.getString("job"); 
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Toast.makeText(this, "您 目前 的 职业 是 "+job, ToastLENGTH LONG).show(); 
$ 


下 面 是 完整 的 请 求 页 面 代码 与 应 答 页 面 代 码 , 结合 效果 界面 加 深 对 Activity 处 理 参数 传递 
的 理解 。 请 求 页 面 的 代码 如 下 : 


public class ActRequestActivity extends AppCompatActivity implements OnClickListener { 
private EditText et_request; 
private TextView tv request; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity act request); 
findViewById(R.id.btn act request).setOnClickListener(this); 
et request = (EditText) find ViewById(R.id.et request); 
tv request = (TextView) findViewById(R.id.tv request); 


(@Override 
public void onClick(View v) í 
if (v.getId() == R.id.btn act request) í 

Intent intent = new Intent(); 
intent.setClass(this, ActResponseActivity.class); 
intent.putExtra("request time", DateUtil.getNow Time()); 
intent.putExtra("request content", et request.getText().toString()); 
startActivityForResult(intent, 0); 


J 
j 
@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
if (data != null) { 
String response_time = data.getStringExtra("response_time"); 
String response_content = data.getStringExtra("response_content"); 
String desc = String.format(" 收 到 返回 消息 : \n 应 答 时 间 为 %s\n 应 答 内 容 为 %s"， 
response time, response content); 
tv request.setText(desc); 
; 
; 
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应 答 页 面 的 代码 如 下 : 


public class ActResponseActivity extends AppCompatActivity implements OnClickListener { 
private EditText et response; 
private TextView tv_response; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity act response); 
findViewById(R.id.btn act response).setOnClickListener(this); 
et response = (EditText) findViewById(R.id.et response); 
tv response = (TextView) find ViewById(R.id.tv response); 
Bundle bundle — getIntent().getExtras(); 
String request time — bundle.getString("request time"); 
String request content — bundle.getString("request content"); 
String desc = String.format(" 收 到 请 求 消息 : 请 求 时 间 为 %sm WRA RAAS", 

request time, request content); 

tv response.setText(desc); 


j 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.btn_act_response) í 
Intent intent = new Intent(); 
Bundle bundle = new Bundle(); 
bundle.putString("response time", DateUtil.getNowTime()); 
bundle.putString("response content", et response.getText().toString()); 
intent.putExtras(bundle); 
setResult(Activity. RESULT OK, intent); 
finish(); 


} 
具体 的 效果 图 分 别 如 图 3-23、 图 3-24、 图 3-25 所 示 。 其 中 ,图 3-23 是 当前 页 面 要 向 下 
个 页 面 发 送 请 求 时 的 界面 ， 图 3-24 是 下 一 个 页 面 准 备 返 回 上 一 个 页 面 时 的 界面 ， 图 3-25 是 上 
-个 页 面 收 到 下 一 个 页 面 应 答 时 的 界面 。 





你 吃 了 没 ? 去 我 家 吃饭 ， 走 走 





传送 请 求 参 数 





图 3-23 准备 向 下 一 个 页 面 发 送 请 求 
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收 到 请 求 消息 : . 
请 求 时 间 为 20:25:55 和 
请 求 内 容 为 你 吃 了 没 ?去 我 家 吃饭 ， 走 走 
传送 请 求 参数 
我 家 饭菜 者 做 好 了 ， 还 是 你 来 我 家 吃饭 ， 来 现 
E 应 ; 间 为 20:27:10 
返回 应 答 参 数 应 答 内 容 为 我 家 名 都 从 好 了 还 是 你 来 和 家 吃饭 ,来 
图 3-24 下 一 个 页 面 准备 返回 消息 图 3-25 上 一 个 页 面 收 到 返回 消息 


3.6 KRMH: 登录 App 


现在 是 实战 项 目 时 间 ， 大 家 如 此 费力 地 看 书 学 习 ， 还 不 就 是 为 了 在 实际 项 目 中 派 上 用 场 。 
凡是 赚钱 的 App， 都 要 掌握 用 户 资源 ， 这 便 少不了 为 用 户 提供 登录 页 面 。 下 面 设 计 并 实现 App 
的 登录 功能 。 


3.6.1 设计 思路 


如 今 楼 市 疯狂 上 涨 ， 要 买房 自然 少不了 房贷 ， 根 据 不 同 的 贷款 方式 与 还 款 方式 计算 出 的 
月 供 数额 各 不 相同 。 如 果 手 机 上 有 房贷 计算 器 ， 就 会 便利 许多 。 房贷 计算 器 绝对 是 一 个 方便 实 
用 的 App, 本 书馆 今 为 止 介绍 的 App 开发 知识 足够 写 一 个 房贷 计算 器 App 了 , 如 图 3-26 所 示 。 
本 章 学 到 的 主要 控件 基本 都 能 派 上 用 场 ， 包 括 RelativeLayout、EditText、RadioButton 、 
CheckBox、Spinner 等 。 读 者 若 有 兴趣 可 自行 编码 练习 ， 补 充 房 贷 计算 的 具体 业务 逻辑 。 

本 章 的 实战 项 目 最 终 选 定 App 登录 页 面 ， 是 因为 要 复习 Activity 的 相关 概念 与 用 法 。 
Activity 是 Android 中 最 常用 的 组 件 ， 后 续 章 节 全 部 都 会 用 到 ， 所 以 要 好 好 加 以 巩固 。 

各 家 App 的 登录 页 面 大 同 小 异 ， 要 么 是 用 户 名 与 密码 组 合 登录 ， 要 么 是 手机 号 与 验证 码 
组 合 登录 ， 如 果 要 做 得 更 好 一 点 ， 就 要 提供 忘记 密码 与 记 住 密码 等 功能 。 我 们 的 App 登录 项 
目 把 这 些 功 能 综合 一 下 ， 都 呈现 到 页 面 上 ， 因 为 是 练 手 ， 所 以 尽量 让 学 到 的 控件 都 派 上 用 场 。 
登录 页 面 的 设计 图 初稿 如 图 3-27 所 示 。 

读者 找 找 看 这 个 效果 图 包含 哪些 本 章 的 新 控件 ? 一 定 会 发 现 以 下 6 个 控件 。 
单 选 按钮 RadioButton: 用 来 区 分 是 密码 登录 还 是 验证 码 登录 。 
下 拉 框 Spinner: 用 于 区 分 用 户 类 型 是 个 人 用 户 还 是 公司 用 户 。 
编辑 框 EditText: 用 来 输入 手机 号 码 和 密码 。 
复 选 框 CheckBox: 用 于 判断 是 否 记 住 密码 。 
相对 布局 RelativeLayout: 指定 手机 号 码 的 编辑 框 放 在 手机 号 码 TextView 的 右边 。 这 里 
使 用 线性 布局 LinearLayout 也 可 以 。 
e 框架 布局 FrameLayout: 忘记 密码 的 按钮 与 密码 输入 框 释 加 。 
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购房 总 价 : 
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图 3-26 房贷 计算 器 的 效果 图 图 3-27 登录 页 面 的 效果 图 


至 此 ， 本 章 介绍 的 新 控件 基本 都 派 上 用 场 了 。 另 外 ， 
本 项 目 还 要 演示 活动 页 面 的 的 跳 转 功能 , 点 击 “ 忘 记 密码 ” 
按钮 跳 转 到 找 回 密码 页 面 , 找 回 密码 页 面 的 效果 如 图 3-28 

找 回 密码 的 页 面 挺 简单 , 主要 问题 是 两 个 页 面 之 间 的 
跳 转 有 哪些 注意 事项 ? 页 面 跳 转 肯定 要 传递 参数 , 一 般 唯 

-标识 的 手机 号 码 要 传 过 去 , 不 然 下 一 个 页 面 不 知道 要 为 
哪个 手机 号 码 修改 密码 ; 新 密码 也 要 传 回去 , 不 然 上 一 个 图 3-28“” 找 回 密码 页 面 的 效果 图 
页 面 不 知道 密码 被 改 成 什么 了 。 

另外 ， 有 一 个 细微 的 用 户 体验 问题 ， 用 户 会 去 找 回 密码 ， 肯 定 是 发 现 输入 的 密码 不 对 。 
修改 完 密码 回 到 登录 页 面 时 , 密码 输入 框 里 还 是 原来 错误 的 密码 , 此 时 用 户 清空 错误 密码 才能 
输入 新 密码 。 我 们 的 App 想 让 用 户 觉得 好 用 ， 就 得 急用 户 之 所 急 、 想 用 户 之 所 想 ， 像 之 前 错 
误 密码 的 情况 应 当 由 App 在 返回 登录 页 面 时 自动 清空 原来 错误 的 密码 。 自 动 清空 的 操作 放 在 
onActivityResult 方法 中 处 理 是 一 个 办 法 ， 但 这 样 处 理 有 一 个 问题 ， 如 果 用 户 直接 按 返 回 键 回 
到 登录 页 面 ，onActivityResult 方法 发 现 数据 为 空 就 不 会 处 理 。 

这 个 问题 其 实 不 难 ， 只 要 认真 看 书 ， 结 合 前 面 关于 Activity 生命 周期 的 说 明 ， 就 能 够 找到 
解决 办 法 。 重 写 onRestart 方法 〈 确 保 是 返回 页 面 ) ， 在 方法 内 部 加 上 清空 密码 框 的 处 理 即 可 。 
这 样 一 来 ,无 论 用 户 是 修改 完 密码 回 到 登录 页 , 还 是 点 击 返 回 键 回 到 登录 页 ，App 都 会 自动 清 
空 密码 框 。 

3.6.2 ”小 知识 : 提醒 对 话 框 AlertDialog 

使 用 验证 码 登 录 时 ，App 要 向 用 户 手机 发 送 短信 验证 码 , 但 发 送 短信 需要 服务 器 支持 ， 所 
以 这 里 暂时 使 用 随机 数 模 拟 验 证 码 , 然后 以 对 话 框 的 形式 在 界面 上 提示 用 户 。 另 外 , 在 登录 的 
过 程 中 ，App 时 常 需要 弹 窗 提示 用 户 选 择 “ 是 ”或 “ 否 ”， 以 此 判断 下 一 步 的 处 理 逻 辑 。 在 本 
实战 项 目 开始 之 前 ， 建 议 读者 先 演练 一 下 提醒 对 话 框 (AlertDialog) 的 用 法 。 
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AlertDialog 是 Android 中 最 常用 的 对 话 框 ， 可 以 完成 常见 的 交互 操作 ， 如 提示 、 确 认 、 选 
择 等 功能 。AlertDialog 没有 公开 的 构造 函数 , 必须 借助 AlertDialog.Builder 才能 完成 参数 设置 ， 
AlertDialog.Builder 的 常用 方法 如 下 。 


e setlcon: 设置 标题 的 图 标 。 

e setTitle: 设置 标题 的 文本 。 

e setMessage: 设置 内 容 的 文本 。 

e setPositiveButton: 设置 肯定 按钮 的 信息 ， 包 括 按钮 文本 和 点 击 监听 器 。 

e setNegativeButton: 设置 否定 按钮 的 信息 ， 包 括 按钮 文本 和 点 击 监听 器 。 

e setNeutralButton: 设置 中 性 按钮 的 信息 ， 包 括 按钮 文本 和 点 击 监听 器 ， 该 方法 比较 少 用 。 


通过 AlertDialog.Builder 设置 完 参数 ， 还 需 调 用 create 方法 才能 生成 AlertDialog 对 象 。 最 
后 调用 AlertDialog 对 象 的 show 方法 ， 在 页 面 上 弹出 提醒 对 话 框 。 
下 面 是 个 提醒 对 话 框 的 代码 : 
public void onClick(View v) í 
if (v.getId() == R.id.btn_alert) í 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setTitle(" 尊 区 的 用 户 "); 
builder.setMessage(" f/f RHR RRI? "); 
builder.setPositiveButton("7R ZZE", new DialogInterface.OnClickListener() í 
@Override 
public void onClick(DialogInterface dialog, int which) í 
tv_alertsetText(" 虽 然 依 依 不 舍 ， 但 是 只 能 离开 了 "); 





D: 

builder.setNegativeButton(" 我 再 想 想 ", new DialogInterface.OnClickListener() ( 
(@Override 
public void onClick(DialogInterface dialog, int which) í 

tv_alert.setText(" 让 我 再 陪 你 三 百 六 十 五 个 日 夜 "); 

j 

D: 

AlertDialog alert = builder.create(); 

alert.show(); 


j 
提醒 对 话 框 的 弹 窗 效果 如 图 3-29 所 示 ， 该 对 话 框 有 标 
题 、 有 内 容 ， 还 有 两 个 按钮 。 尊敬 的 用 户 
用 户 点 击 不 同 的 按钮 会 触发 不 同 的 处 理 逻 辑 。 图 3-30 fia 69 3550803032 
所 示 为 点 击 “我 再 想 想 ”按钮 后 的 页 面 ， 图 3-31 所 示 为 点 
击 “ 残 忍 印 载 ”按钮 后 的 页 面 。 


我 再 想 想 。 残忍 卸载 





图 3-29 AlertDialog 的 效果 图 
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Middle Middle 


弹出 提醒 框 


让 我 再 陪 你 三 百 六 十 五 个 日 夜 





弹出 提醒 框 
虽然 依依 不 舍 ， 但 是 只 能 离开 了 


图 3-30 点 击 “我 再 想 想 ” 的 截图 图 3-31 点击“ 残忍 卸载 ”的 截图 
363 ”代码 示例 


前 面 的 设计 不 但 给 出 了 两 个 页 面 的 效果 图 ， 而 且 给 出 了 业务 逻辑 的 大 概 思路 ， 接 下 来 主 
要 是 编码 将 其 实现 。 编 码 过 程 分 为 3 个 步 又 : 

ED) 先 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 登录 页 面 的 代码 文件 取 名 LoginMainActivity;java, 
布局 文件 取 名 activity login.xml; 找 回 密码 页 面 的 代码 文件 取 名 LoginForgetActivityjava， 布 局 文件 取 
名 activity login_forgetxml。 记 得 在 AndroidManifest.xml 中 注册 两 个 页 面 的 acitivity 节点 ， 注 册 代码 
如 下 : 








«activity android:name=".LoginMainActivity" /> 
<activity android:name=".LoginForgetActivity" /> 
CX302 在 res/layout 目录 下 创建 布局 文件 activity login.xml 和 activity_login_forgetxml， 根 据 页 
面 效果 图 编写 两 个 页 面 的 布局 定义 文件 。 
CXX03 在 项 目的 包 名 目录 下 创建 类 LoginMainActivity 和 LoginForgetActivity, 填 入 具体 的 控件 
操作 与 业务 逻辑 代码 。 

















下 面 是 登录 页 面 LoginMainActivity.java 的 主要 代码 片段 : 


public void onClick(View v) { 
String phone = et_phone.getText().toString(); 
if (v.getId() = R.id.btn forget) í 
if (phone—-null || phone.length()«11) í 
Toast.makeText(this, "请 输入 正确 的 手机 号 ", Toast. LENGTH. SHORT).show(); 
return; 
h 
if(rb password.isChecked() — true) í 
Intent intent — new Intent(this, LoginForgetActivity.class); 
intent.putExtra(" phone", phone); 
startActivityForResult(intent, mRequestCode); 
} else if (rb verifycode.isChecked() = true) í 
mVerifyCode = String.format("9606d", (int)(Math.random()*1000000941000000)); 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setTitle(" 请 记 住 验证 码 "); 
builder.setMessage(" 手 机 号 "+phone+", 本 次 验证 码 是 "HmVerifyCode+", 请 输入 验证 码 "); 
builder.setPositiveButton(" 好 的 ", null); 
AlertDialog alert = builder.create(); 
alert.show(); 
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J 
} else if (v.getld() — R.id.btn login) í 
if (phone—null || phone.length()«11) í 
Toast.makeText(this, "请 输入 正确 的 手机 号 ", Toast. LENGTH SHORT).show(); 
return; 
; 
if(rb password.isChecked() = true) í 
if (et password.getText().toString().equals(mPassword) != true) í 
Toast.makeText(this, "请 输入 正确 的 密码 ", Toas.LENGTH. SHORT).show(); 
return; 
} else { 
loginSuccess(); 
; 
} else if (rb verifycode.isChecked() = true) í 
if (et password.getText().toString().equals(mVerifyCode) !— true) í 
Toast.makeText(this, "请 输入 正确 的 验证 码 ", Toast.LENGTH. SHORT).show(); 
return; 
) else í 
loginSuccess(); 


; 


(@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) í 
if (requestCode — mRequestCode && data!=null) í 
/用 户 密码 已 改 为 新 密码 
mPassword = data.getStringExtra("new password"); 


j 


// 从 修改 密码 页 面 返回 登录 页 面 ， 要 清空 密码 的 输入 框 
(@Override 
protected void onRestart() í 
et password.setText(""); 
super. onRestart(); 
} 


private void loginSuccess() { 
String desc = String.format(" 您 的 手机 号 码 是 %s， 类 型 是 %s。 恭 喜 你 通过 登录 验证 ， 点击“ 确 
定 ” 按 钮 返回 上 个 页 面 ", et phone.getText().toString(), typeArray[mType]); 
AlertDialog. Builder builder = new AlertDialog.Builder(this); 
builder.setTitle(" 登 录 成 功 "); 
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builder.setMessage(desc); 
builder.setPositiveButton(" 确 定 返 回 ", new DialogInterface.OnClickListener() í 
(@Override 
public void onClick(DialogInterface dialog, int which) í 
finish(); 


» 

builder.setNegativeButton(" 我 再 看 看 ", null); 
AlertDialog alert = builder.create(); 
alert.show(); 


1 
下 面 是 找 回 密码 页 面 LoginForgetActivity.java 的 代码 : 
public class LoginForgetActivity extends AppCompatActivity implements OnClickListener í 





private EditText et password first; 
private EditText et password second; 
private EditText et. verifycode; 
private String mVerifyCode; 

private String mPhone; 


(a Override 

protected void onCreate( Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity login forget); 
et password first = (EditText) find ViewById(R.id.et password first); 
et password second = (EditText) find ViewById(R.id.et password second); 
et verifycode — (EditText) findViewById(R.id.et verifycode); 
findViewBylId(R.id.btn verifycode).setOnClickListener(this); 
findViewById(R.id.btn confirm).setOnClickListener(this); 
mPhone = getIntent().getStringExtra("phone"); 

j 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.btn verifycode) { 
if (mPhone=null || mPhone.length()<11) í 
Toast.makeText(this, "请 输入 正确 的 手机 号 ", Toast. LENGTH SHORT).show(); 
return; 
; 
mVerifyCode = String.format("%06d", (int) (Math.random() * 1000000 % 1000000)); 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setTitle(" 请 记 住 验证 码 "); 
builder.setMessage(" 手 机 号 "+mPhonet+"， 本 次 验证 码 是 "+mVerifyCodet+"， 请 输入 验证 码 "); 
builder.setPositiveButton(" 好 的 ", null); 
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局 ) 


AlertDialog alert = builder.create(); 

alert.show(); 
} else if (v.getld() = R.id.btn confirm) í 

String password first — et password first.getText().toString(); 

String password second — et password second.getText().toString(); 

if (password first—null || password first.length()-6 || 

password second—-null || password second.length()«6) í 
Toast.makeText(this, "请 输入 正确 的 新 密码 ", Toast. LENGTH. SHORT).show(); 
return; 

} else if (password first.equals(password second) != true) í 
Toast.makeText(this, "两 次 输入 的 新 密码 不 一 致 ", Toast.LENGTH. SHORT).show(); 
return; 

} else if (et verifycode.getText().toString().equals(mVerifyCode) != true) ( 
Toast.makeText(this, "请 输入 正确 的 验证 码 ", Toast. LENGTH. SHORT).show(); 
return; 

} else ( 

Toast.makeText(this, "密码 修改 成 功 ", Toast. LENGTH. SHORT).show(); 
Intent intent = new Intent(); 

intent.putExtra("new password", password first); 
setResult(Activity.RESULT OK, intent); 

finish(); 


37 ^h 结 


本 章 主要 介绍 App 开发 的 中 级 控件 相关 知识 ， 包 括 其 他 布局 的 用 法 (相对 布局 、 框 架 布 
、 特 殊 按钮 的 用 法 〈 复 选 框 、 开 关 按 钮 、 单 选 按钮 )、 适 配 视图 的 基本 用 法 (下 拉 框 、 数 


组 适配器 、 简 单 适配器 〉、 编 辑 框 的 用 法 (文本 编辑 框 、 自 动 完成 编辑 框 》、Activity 组 件 的 
基本 用 法 (生命 周期 、 意 图 、 传 递 消息 ) 。 最 后 设计 了 一 个 实战 项 目 “ 登 录 App”, EAM A 
的 App 编码 中 , 采用 前 面 介绍 的 大 部 分 布局 和 控件 , 以 及 Activity 跳 转 与 返回 时 的 消息 请 求 与 
应 答 ， 初 步 在 实际 代码 中 运用 生命 周期 方法 。 最 后 介绍 了 提醒 对 话 框 的 用 法 。 


H 








通过 本 章 的 学 习 ， 读 者 应 该 能 掌握 以 下 3 种 开发 技能 

CD 在 布局 文件 中 合理 使 用 本 章 学 到 的 布局 和 控件 。 

(2) 在 代码 中 合理 调用 本 章 学 到 的 布局 和 控件 的 相关 方法 。 

(3) 学 会 Activity 组 件 的 用 法 ， 如 在 页 面 之 间 跳 转 的 消息 传递 操作 和 在 合适 的 场合 重 写 


生命 周期 的 方法 。 





TTET 数据 存储 


本 章 介 绍 Android 四 种 主要 存储 方式 的 用 法 , 包括 共享 
参数 SharedPreferences、 数 据 库 SQLite、SD 卡 文件 、App 
的 全 局 内 存 ， 另 外 介绍 重要 组 件 之 一 的 Application 的 基本 
概念 与 常见 用 法 。 最 后 , 结合 本 章 所 学 的 知识 演示 实战 项 目 
“购物 车 ”的 设计 与 实现 。 





A M 
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4.4 共享 参数 SharedPreferences 


本 节 介绍 Android 的 键 值 对 存储 方式 一 一 共享 参数 SharedPreferences 的 使 用 方法 ， 包 括 
如 何 保存 数据 与 读 取 数据 ， 通 过 共享 参数 结合 “登录 App” 项 目 实现 记 住 密码 功能 。 


4.1.1 基本 用 法 


SharedPreferences 是 Android 的 一 个 轻 量 级 存储 工具 ， 采 用 的 存储 结构 是 Key-Value 的 键 
值 对 方式 ， 类 似 于 Java 的 Properties 类 ， 二 者 都 是 把 Key-Value 的 键 值 对 保存 在 配置 文件 中 。 
不 同 的 是 Properties 的 文件 内 容 是 Key=Value 这 样 的 形式 ， 而 SharedPreferences 的 存储 介质 是 
符合 XML 规范 的 配置 文件 。 保存 SharedPreferences 键 值 对 信息 的 文件 路 径 是 /data/data/ 应 用 包 
名 /shared_prefs/ 文 件 名 .xml。 下 面 是 一 个 共享 参数 的 XML 文件 示例 : 


<?xml version='1.0' encoding='utf-8' standalone='yes' ?> 
<map> 

<string name="name">Mr Lee</string> 

<int name="age" value="30" /> 

<boolean name="married" value="true" /> 

«float name-"weight" value=" 100.0" > 
</map> 


基于 XML 格式 的 特点 ，SharedPreferences 主要 适用 于 如 下 场合 : 


(1) 简单 且 孤 立 的 数据 。 若 是 复杂 且 相 互 间 有 关 的 数据 ， 则 要 保存 在 数据 库 中 。 
OD 文本 形式 的 数据 。 若 是 二 进 制 数据 ， 则 要 保存 在 文件 中 。 
(3) 需要 持久 化 存储 的 数据 。 在 App 退出 后 再 次 启动 时 ， 之 前 保存 的 数据 仍然 有 效 。 


实际 开发 中 ， 共 享 参数 经 常 存储 的 数据 有 App 的 个 性 化 配置 信息 、 用 户 使 用 App 的 行为 
信息 、 临 时 需要 保存 的 片段 信息 等 。 

SharedPreferences 对 数据 的 存储 和 读 取 操 作 类 似 于 Map， 也 有 put 函数 用 于 存储 数据 、get 
函数 用 于 读 取 数据 。 在 使 用 共享 参数 之 前 ， 要 先 调用 getSharedPreferences 函数 声明 文件 名 与 
操作 模式 ， 示 例 代码 如 下 : 

SharedPreferences sps= getSharedPreferences("share", Context.MODE PRIVATE); 


getSharedPreferences 方法 的 第 一 个 参数 是 文件 名 ， 上 面 的 share 表示 当前 使 用 的 共享 参数 
文件 名 是 share.xml; 第 二 个 参数 是 操作 模式 ， 一 般 都 填 MODE_PRIVATE， 表 示 私 有 模式 。 
共享 参数 存储 数据 要 借助 于 Editor 类 ， 示 例 代 码 如 下 : 
SharedPreferences.Editor editor = sps.edit(); 
editor.putString("name", "Mr Lee"); 
editor.putInt("age", 30); 
editor.putBoolean("married", true); 
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editor.putFloat("weight", 100f); 
editor.commit(); 


共享 参数 读 取 数据 相对 简单 ， 直接 使 用 对 象 即 可 完成 数据 读 取 方 法 的 调用 ,注意 get 方法 
的 第 二 个 参数 表示 默认 值 ， 示 例 代码 如 下 : 
String name = sps.getString("name", ""); 
int age = sps.getInt("age", 0); 
boolean married = sps.getBoolean("married", false); 
float weight = sps.getFloat("weight", 0); 


下 面 通 过 页 面 录入 信息 演示 SharedPreferences 的 存 取 过 程 ， 如 图 4-1 所 示 。 在 页 面 上 利用 
EditText 录入 用 户 注册 信息 ， 并 保存 到 共享 参数 文件 中 。 在 另 一 个 页 面 ，App 从 共享 参数 文件 
中 读 取 用 户 注册 信息 ， 并 将 注册 信息 依次 显示 在 页 面 中 ， 如 图 4-2 所 示 。 
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共享 参数 中 保存 的 信息 如 下 : 
married 的 取 值 为 true 
weight 的 取 值 为 70.000000 
height 的 取 值 为 175 
count 的 取 值 为 4 
update_time 的 取 值 为 2016-10-01 18:25:18 
age 的 取 值 为 30 
name 的 取 值 为 Jack 
first 的 取 值 为 false 


保存 到 共享 参数 





图 4-1 写 入 共享 参数 图 4-2 ”从 共享 参数 读 取 
44.2 ”实现 记 住 密码 功能 


上 一 章 的 实战 项 目 “ 登 录 App” 页 面 下 方 有 一 个 “ 记 住 密码 ” 复 选 框 ， 当 时 只 是 为 了 演示 
控件 的 运用 ， 并 未 真正 记 住 密码 。 因 为 用 户 退 出 后 重新 进入 登录 页 面 ，App 没有 回忆 起 上 次 用 
户 的 登录 密码 。 现 在 我 们 利用 共享 参数 对 该 项 目 进行 改造 ， 使 之 实现 记 住 密码 的 功能 。 

改造 的 内 容 主 要 有 3 处 : 

(1) 声明 一 个 SharedPreferences 对 象 ， 并 在 onCreate 函数 中 调用 getSharedPreferences Jr 
法 对 该 对 象 进行 初始 化 操作 。 

(2) 登录 成 功 时 ， 如 果 用 户 勾 选 了 “ 记 住 密码 ”， 就 使 用 共享 参数 保存 手机 号 码 与 密码 。 
在 loginSuccess 函数 中 增加 如 下 代码 : 

if (bRemember) { 
SharedPreferences.Editor editor = mShared.edit(); 
editor.putString("phone", et phone.getText().toString()); 
editor.putString("password", et password.getText().toString()); 
editor.commit(); 

H 


(3) 在 打开 登录 页 面 时 ，App 从 共享 参数 中 读 取 手 机 号 码 与 密码 ， 并 展示 在 界面 上 。 在 








Android Studio FRR: 从 零 基 础 到 App 上 线 





onCreate 函数 中 增加 如 下 代码 : 

String phone = mShared.getString("phone", ""); 

String password = mShared.getString("password", ""); 

et phone.setText(phone); 

et password.setText(password); 

修改 完毕 后 ， 如 果 不 出 意料 ， 只 要 用 户 上 次 登录 成 功 时 色 选 “ 记 住 密码 ”， 下 次 进入 登 
录 页 面 时 App 就 会 自动 填写 上 次 登录 的 手机 号 码 与 密码 。 具 体 的 效果 如 图 4-3 和 图 4-4 所 示 。 
其 中 ， 图 4-3 所 示 为 用 户 首次 登录 成 功 ， 此 时 色 选 了 “ 记 住 密码 ”; 图 4-4 所 示 为 用 户 再 次 进 
入 登录 页 面 ， 因 为 上 次 登录 成 功 时 已 经 记 住 密码 ， 所 以 这 次 页 面 会 自动 展示 保存 的 登录 信息 。 
Storage Storage 
O 验证 码 登录 O 验证 码 登录 
RE: 个 人 用 户 : 个 人 用 户 


| 手机 号 码 : 15960238696 


记 住 密码 





图 4-3 将 登录 信息 保存 到 共享 参数 图 4-4 ”从 共享 参数 读 取 登录 信息 
42 数据库 SQLite 


本 节 介 绍 Android 的 数据 库存 储 方式 一 一 SQLite 的 使 用 方法 ， 包 括 如 何 建 表 和 删 表 、 变 
更 表 结构 以 及 对 表 数 据 进行 增加 、 删除 、 修 改 、 查 询 等 操作 , 然后 通过 SQLite 结合 “登录 App” 
项 目 改进 记 住 密码 功能 。 


4.2.1 SQLite 的 基本 用 法 


SQLite 是 一 个 小 巧 的 嵌入 式 数据 库 ， 使 用 方便 、 开 发 简单 ， 手 机 上 最 早 由 iOS 运用 ， 后 
来 Android 也 采用 了 SQLite. SQLite 的 多 数 sql 语法 与 Oracle 一 样 ， 下 面 只 列 出 不 同 的 地 方 : 


d) 建 表 时 为 避免 重复 操作 ， 应 加 上 IF NOT EXISTS 关键 词 ， 例 如 CREATE TABLE IF 
NOT EXISTS table name. 
(2) 删 表 时 为 避免 重复 操作 ， 应 加 上 IF EXISTS 关键 词 ， 例 如 DROP TABLE IF EXISTS 
table name. 
G) 添加 新 列 时 使 用 ALTER TABLE table name ADD COLUMN .…， 注 意 比 Oracle 多 了 
-个 COLUMN 关键 字 。 
(4) 在 SQLite "P, ALTER 语句 每 次 只 能 添加 一 列 ， 如果 要 添加 多 列 , 就 只 能 分 多 次 添加 。 
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(5) SQLite 支持 整 型 INTEGER、 字 符 串 VARCHAR、 浮 点 数 FLOAT， 但 不 支持 布尔 类 型 。 
布尔 类 型 数 要 使 用 整 型 保存 ， 如 果 直 接 保存 布尔 数据 ， 在 入 库 时 SQLite 就 会 自动 将 其 转 为 0 
或 1，0 表示 false, 1 表示 true. 

(6) SQLite 建 表 时 需要 一 个 唯一 标识 字段 ， 字 段 名 为 id。 每 建 一 张 新 表 都 要 例行公事 加 
上 该 字段 定义 , 具体 属性 定义 为 id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, 

(7) 条 件 语句 等 号 后 面 的 字符 串 值 要 用 单 引号 括 起 来 ， 如 果 没 用 使 用 单 引 号 括 起 来 ， 在 
运行 时 就 会 报错 。 

SQLiteDatabase 是 SQLite 的 数据 库 管理 类 ， 我 们 可 以 在 活动 页 面 代码 或 任何 能 取 到 
Context 的 地 方 获 取 数 据 库 实例 ， 参 考 代码 如 下 : 
// 创 建 数据 库 ， 如 果 已 存在 就 打开 
SQLiteDatabase db = getApplicationContext().openOrCreateDatabase("test.db", 
ContextMODE PRIVATE, null); 


LARZ PE 
getApplicationContext().deleteDatabase("test.db"); 


SQLiteDatabase 提供 了 若干 操作 数据 表 的 API， 常 用 的 方法 有 3 类 ， 列 举 如 下 : 
1. 管理 类 ， 用 于 数据 库 层面 的 操作 。 


openDatabase: 打开 指定 路 径 的 数据 库 。 
isOpen: 判断 数据 库 是 否 已 打开 。 
close: 关闭 数据 库 。 

getVersion: 获取 数据 库 的 版 本 号 。 
setVersion: 设置 数据 库 的 版 本 号 。 


2. 事务 类 ， 用 于 事务 层面 的 操作 。 


e beginTransaction: 开始 事务 。 

e setTransactionSuccessful: 设置 事务 的 成 功 标 志 。 

e endTransaction: 结束 事务 。 执 行 本 方法 时 ， 系 统 会 判断 是 否 已 执行 setTransactionSuccessful， 
如 果 之 前 已 设置 就 提交 ， 如 果 没 有 设置 就 回 滚 。 


3. 数据 处 理 类 ， 用 于 数据 表层 面 的 操作 。 


execSQL: 执行 拼接 好 的 SQL 控制 语句 。 一 般 用 于 建 表 、 删 表 、 变 更 表 结 构 。 
delete: 删除 符合 条 件 的 记录 。 

update: 更 新 符合 条 件 的 记录 。 

insert: 插入 一 条 记录 。 

query: 执行 查询 操作 ， 返 回 结果 集 的 游标 。 

rawQuery: 执行 拼接 好 的 SQL 查询 语句 ， 返 回 结果 集 的 游标 。 
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4.2.2 SQLiteOpenHelper 


SQLiteDatabase 存在 局 限 性 ， 例 如 必须 小 心 、 不 能 重复 地 打开 数据 库 ， 处 理 数 据 库 的 升级 
很 不 方便 。Android 提供 了 一 个 辅助 工具 一 一 SQLiteOpenHelper， 用 于 指导 我 们 进行 SQLite 
的 合理 使 用 。 

SQLiteOpenHelper 的 具体 使 用 步骤 如 下 : 


ED) 新 建 一 个 继承 自 SQLiteOpenHelper 的 数据 库 操作 类 ， 提 示 重 写 onCreate 和 onUpgrade 
两 个 方法 。 其 中 ，onCreate 方法 只 在 第 一 次 打开 数据 库 时 执行 ， 在 此 可 进行 表 结 构 创建 的 操作 ; 
onUpgrade 方法 在 数据 库 版 本 升 高 时 执行 ， 因 此 我 们 可 以 在 onUpgrade 函数 内 部 根据 新 旧版 本 号 进行 
表 结 构 变更 处 理 。 
ED 封装 保证 数据 库 安 全 的 必要 方法 ， 包 括 获取 单 例 对 象 、 打开 数据 库 连接 、 关 闭 数据 库 
连接 。 
o 获取 单 例 对 象 : 确保 App 运行 时 数据 库 只 被 打开 一 次 ， 避 免 重复 打开 引起 错误 。 
° 打开 数据 库 连 接 : SQLite 有 锁 机 制 ， 即 读 锁 和 写 锁 的 处 理 ; 故而 数据 库 连 接 也 分 两 种 ， 读 连接 
可 调用 SQLiteOpenHelper 的 getReadableDatabase 方法 获得 ， 写 连接 可 调用 getWritableDatabase 
获得 。 
e 关闭 数据 库 连 接 : 数据 库 操作 完毕 后 ， 应 当 调用 SQLiteDatabase 对 象 的 close 方法 关闭 连接 。 
EI 提供 对 表 记录 进行 增加 、 删 除 、 修 改 、 查 询 的 操作 方法 。 


可 被 SQLite 直接 使 用 的 数据 结构 是 ContentValues 类 ， 类 似 于 映射 Map, PEB put 和 get 
方法 用 来 存 取 键 值 对 。 区 别 之 处 在 于 ContentValues 的 键 只 能 是 字符 串 ， 查 看 ContentValues 
的 源码 会 发 现 其 内 部 保存 键 值 对 的 数据 结构 就 是 HashMap “private HashMap<String, Object> 
mValues;". ContentValues 主要 用 于 记录 增加 和 更 新 操作 , BI SQLiteDatabase 的 insert 和 update 
方法 。 

对 于 查询 操作 来 说 ， 使 用 的 是 另 一 个 游标 类 Cursor。 调 用 SQLiteDatabase 的 query 和 
rawQuery 方法 时 ， 返 回 的 都 是 Cursor 对 象 ， 因 此 获取 查询 结果 要 根据 游标 的 指示 一 条 一 条 遍 
历 结果 集合 。Cursor 的 常用 方法 可 分 为 3 类， 说 明 如 下 : 

. 游标 控制 类 方法 ， 用 于 指定 游标 的 状态 。 
close: 关闭 游标 。 
isClosed: 判断 游标 是 否 关闭 。 
isFirst: 判断 游标 是 否 在 开头 。 
isLast: 判断 游标 是 否 在 末尾 。 
2. 游标 移动 类 方法 ， 把 游标 移动 到 指定 位 置 。 
e moveToFirst: 移动 游标 到 开头 。 
e moveToLast: 移动 游标 到 末尾 。 
e moveToNext: 移动 游标 到 下 一 条 记录 。 
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e moveToPrevious: 移动 游标 到 上 一 条 记录 。 
e move: 往 后 移动 游标 若干 条 记录 。 
e moveToPosition: 移动 游标 到 指定 位 置 的 记录 。 


3. 获取 记录 类 方法 ， 可 获取 记录 的 数量 、 类 型 以 及 取 值 。 


e getCount: 获取 结果 记录 的 数量 。 
e getlnt: 获取 指定 字段 的 整 型 值 。 
e getFloat: 获取 指定 字段 的 浮 点 数值 。 
e getString: 获取 指定 字段 的 字符 囊 值 。 
e getType: 获取 指定 字段 的 字段 类 型 。 


鉴于 数据 库 操作 的 特殊 性 ， 不 方便 单独 演示 某 个 功能 ， 接 下 来 从 创建 数据 库 开始 介 绍 ， 
完整 演示 一 下 数据 库 的 读 写 操作 。 如 图 4-5 和 图 4-6 所 示 ， 在 页 面 上 分 别 录入 两 个 用 户 的 注册 
信息 并 保存 到 SQLite。 从 SQLite 读 取 用 户 注册 信息 并 展示 在 页 面 上 ， 如 图 4-7 所 示 。 


Se Storage 


已 婚 
保存 到 数据 库 








删除 所 有 记录 


数据 库 查询 到 2 条 记录 ， 详 情 如 下 : 
第 1 条 记录 信息 如 下 : 


身高 为 175 

体重 为 70.000000 

婚 否 为 rue 

更 新 时 间 为 2016-10-01 18:29:27 
第 2 条 记录 信息 如 下 

姓名 为 Lucy 


婚 否 为 false 
更 新 时 间 为 2016-10-01 18:29:48 
47 从 SQLite 中 读 取 两 条 注册 记录 


下 面 是 用 户 注册 信息 数据 库 的 SQLiteOpenHelper 操作 类 的 完整 代码 : 


public class UserDBHelper extends SQLiteOpenHelper í 
private static final String TAG = "UserDBHelper"; 
private static final String DB NAME = "user.db"; 








保存 到 数据 库 


图 4-6 第 二 条 注册 信息 保存 到 数据 库 
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private static final int DB. VERSION = 1; 

private static UserDBHelper mHelper = null; 

private SQLiteDatabase mDB = null; 

private static final String TABLE_NAME = "user_info"; 


private UserDBHelper(Context context) í 
super(context, DB NAME, null, DB VERSION); 


private UserDBHelper(Context context, int version) í 
super(context, DB NAME, null, version); 


public static UserDBHelper getInstance(Context context, int version) í 
if (version > 0 & & mHelper = null) í 
mHelper = new UserDBHelper(context, version); 
) else if (mHelper == null) í 
mHelper = new UserDBHelper(context); 
J 


return mHelper; 


public SQLiteDatabase openReadLink() í 
if (mDB = null || mDB.isOpen() != true) í 
mDB = mHelper.getReadableDatabase(); 
J 


return mDB; 


public SQLiteDatabase openWriteLink() í 
if (mDB = null || nDB.isOpen() !- true) í 
mDB = mHelper.getWritableDatabase(); 
j 


return mDB; 


public void closeLink() í 
if (mDB != null && mDB.isOpen() == true) í 
mDB .close(); 
mDB - null; 
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public String getDBName() í 
if (mHelper != null) í 
return mHelper.getDatabaseName(); 
} else í 
return DB_NAME; 


@Override 
public void onCreate(SQLiteDatabase db) { 
Log.d(TAG, "onCreate"); 
String drop sql = "DROP TABLE IF EXISTS " + TABLE NAME + ";"; 
db.execSQL(drop_sql); 
String create sql = "CREATE TABLE IF NOT EXISTS " + TABLE NAME+"(" 
*" id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL," 
+ "name VARCHAR NOT NULL," + "age INTEGER NOT NULL," 
+ "height LONG NOT NULL," + "weight FLOAT NOT NULL," 
+ "married INTEGER NOT NULL," + "update time VARCHAR NOT NULL" 
// 演 示 数 据 库 升 级 时 要 先 注释 下 面 这 行 代码 
+ "phone VARCHAR" + "password VARCHAR" + ");"; 
Log.d(TAG, "create sql:" + create sql); 
db.execSQL(create sql); 


@Override 

public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
Log.d(TAG, "onUpgrade oldVersion="+oldVersion+", new Version="+new Version); 
if (newVersion > 1) { 


/Android 的 ALTER 命令 不 支持 一 次 添加 多 列 ， 只 能 分 多 次 添加 


String alter sql = "ALTER TABLE "+TABLE NAME + " ADD COLUMN "+ "phone 


VARCHAR;"; 
Log.d(TAG, "alter sql:" alter sql); 
db.execSQL(alter sql); 
alter sql = "ALTER TABLE " + TABLE. NAME +" ADD COLUMN " + "password 
VARCHAR;"; 
Log.d(TAG, "alter sql:" + alter sql); 
db.execSQL(alter sql); 
J] 
H 


public int delete(String condition) í 
int count - mDB.delete(TABLE NAME, condition, null); 


return count; 
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} 

public int deleteAll() í 
int count = mDB.delete(TABLE NAME, "1=1", null); 
return count; 

} 


public long insert(UserInfo info) { 
ArrayList<Userlnfo> infoArray = new ArrayList<UserInfo>(); 
infoArray.add(info); 
return insert(infoArray); 


public long insert(ArrayList<UserInfo> infoArray) í 
long result = -1; 
for (inti = 0; i < infoArray.size(); i+) í 
UserInfo info = infoArray.get(i); 
ArrayList-UserInfo» tempArray = new ArrayList-UserlInfo»(); 
/ 如 果 存 在 同名 记录 ， 就 更 新 记录 。 注 意 条件 语 名 的 等 号 后 面 要 用 单 引号 括 起 来 
if (info.name!=null && info.name.length()>0) í 
String condition = String.format("name-"/s"", info.name); 
tempArray = query(condition); 
if (tempArray.size() > 0) í 
update(info, condition); 
result = tempArray.get(0).rowid: 
continue; 
; 
j 
/ 如 果 存 在 同样 的 手机 号 码 ， 就 更 新 记录 
if (info.phone!=null && info.phone.length()>0) í 
String condition = String.format("phone='%s'", info.phone); 
tempArray = query(condition); 
if (tempArray.size() > 0) í 
update(info, condition); 
result = tempArray.get(0).rowid; 
continue; 
; 
; 
/ 如 果 不 存在 唯一 性 重复 的 记录 ， 就 插入 新 记录 
ContentValues cv = new ContentValues(); 
cv.put("name", info.name); 
cv.put("age", info.age); 
cv.put("height", info.height); 
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cv.put("weight", info.weight); 
cv.put("married", info.married); 
cv.put("update time", info.update time); 
cv.put("phone", info.phone); 
cv.put("password", info.password); 
result = mDB.insert(TABLE NAME, "", cv); 
/ 添加 成 功 后 返回 行 号 ， 失 败 则 返回 -1 
if (result == -1) í 

retum result; 


J 


return result; 


public int update(UserlInfo info, String condition) í 
ContentValues cv = new Content Values(); 
cv.put("name", info.name); 
cv.put("age", info.age); 
cv.put("height", info.height); 
cv.put("weight", info.weight); 
cv.put("married", info.married); 
cv.put("update time", info.update time); 
cv.put("phone", info.phone); 
cv.put("password", info.password); 
int count = mDB.update(TABLE NAME, cv, condition, null); 
return count; 


public int update(UserlInfo info) í 
return update(info, "rowid-"-info.rowid); 


public ArrayList-UserInfo^ query(String condition) í 
String sql = String.format("select rowid, id,name,age,height,weight,married,update time," + 
"phone,password from %s where ?6s;", TABLE NAME, condition); 
Log.d(TAG, "query sql: "+sql); 
ArrayList-UserInfo- infoArray = new ArrayList-UserlInfo^(); 
Cursor cursor = mDB.rawQuery(sql, null); 
if (cursor.moveToFirst()) í 
for (;; cursor.moveToNext()) í 
Userlnfo info = new Userlnfo(); 
info.rowid — cursor.getLong(0); 
info.xuhao = cursor getInt(1); 
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info.name = cursor.getString(2); 
info.age = cursor.getlnt(3); 
info.height = cursor.getLong(4); 
info.weight = cursor.getFloat(5); 
//SQLite 没有 布尔 型 ， 用 0 表示 false, J 1 表示 true 
info.married = (cursor.getlnt(6)==0)?false:true; 
info.update time = cursor.getString(7); 
info.phone = cursor.getString(8); 
info.password = cursor.getString(9); 
infoArray.add(info); 
if (cursor.isLast() — true) í 
break; 
} 
} 
h 
cursor.close(); 
return infoArray; 


i 


public UserInfo queryByPhone(String phone) í 
UserInfo info = null; 
ArrayList-UserlInfo-» infoArray = query(String.format("phone-' 96s", phone)); 
if (infoArray.size() > 0) í 
info — infoArray.get(0); 
J 


return info; 


j 
423 ”优化 记 住 密码 功能 


在 “4.1.2 实现 记 住 密码 功能 ”中 ， 我 们 利用 共享 参数 实现 了 记 住 密码 的 功能 ， 不 过 这 个 
方法 有 局 限 ， 只 能 记 住 一 个 用 户 的 登录 信息 , 并 且 手 机 号 码 跟 密 码 不 存在 从 属 关 系 ， 如果 换个 
手机 号 码 登 录 , 前 一 个 用 户 的 登录 信息 就 被 覆盖 了 。 真正 意义 上 的 记 住 密码 功能 是 先 输入 手机 
号 码 , 然后 根据 手机 号 匹配 保存 的 密码 ,一 个 密码 对 应 一 个 手机 号 码 ， 从 而 实现 具体 手机 号 码 
的 密码 记忆 功能 。 

现在 我 们 运用 SQLite 技术 分 条 存储 不 同 用 户 的 登录 信息 ， 并 提供 根据 手机 号 码 查找 登录 





(1) 声 明 一 个 UserDBHelper 对 象 , 然后 在 活动 页 面 的 onResume 方法 中 打开 数据 库 连 接 ， 
在 onPasue 方法 中 关闭 数据 库 连 接 ， 示 例 代 码 如 下 : 
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@Override 

protected void onResume() { 
super.onResume(); 
mHelper = UserDBHelper.getInstance(this, 2); 
mHelper.openWriteLink(); 

} 

@Override 

protected void onPause() { 
super.onPause(); 
mHelper.closeLink(); 

} 


(2) 登录 成 功 时 ， 如 果 用 户 勾 选 了 “ 记 住 密码 ”， 就 使 用 数据 库 保 存 手机 号 码 与 密码 在 
内 的 登录 信息 。 在 loginSuccess 函数 中 增加 如 下 代码 : 

if (bRemember) ( 
UserlInfo info = new UserlInfo(); 
info.phone = et phone.getText().toString(); 
info.password = et password.getText().toString(); 
info.update time = DateUtil.getNowDateTime("yyyy-MM-dd HH:mm:ss"); 
mHelper.insert(info); 

|， 

(3) 再 次 打开 登录 页 面 ， 用 户 输入 手机 号 完毕 后 点 击 密码 输入 框 时 ，App 到 数据 库 中 根 
据 手机 号 查找 登录 记录 ， 并 将 记录 结果 中 的 密码 填 入 密码 框 。 

看 到 这 里 ， 读 者 也 许 已 经 想到 给 密码 框 注册 点 击 事件 ， 然 后 在 onClick 方法 中 补充 数据 库 
读 取 操 作 。 可 是 EditText 比较 特殊 ， 点 击 后 只 是 让 其 获得 焦点 ， 再 次 点 击 才 会 触发 点 击 事件 。 
也 就 是 说 ， 要 连续 点 击 两 次 EditText 才 会 处 理 点 击 事件 。Android 有 时 就 是 这 么 调皮 捣蛋 ， 你 
让 它 往 东 ， 它 偏偏 往 西 。 难 不 成 叫 用 户 将 就 一 下 点 击 两 次 ? 用 户 表 定 觉 得 这 个 App 古怪 、 难 
用 , 还 是 卸载 好 了 …… 这 里 提供 一 个 解决 办 法 ， 先 给 密码 框 注册 一 个 焦点 变更 监听 器 ， 比 如 下 
面 这 行 代码 : 





et_password.setOnFocusChangeListener(this); 


这 个 焦点 变更 监听 器 要 实现 接口 OnFocusChangeListener, ， 对 应 的 事件 处 理 方 法 是 
onFocusChange， 将 数据 库 查 询 操作 放 在 该 方法 中 ， 详 细 代码 如 下 : 


@Override 
public void onFocusChange(View v, boolean hasFocus) { 
String phone = et_phone.getText().toString(); 
if (v.getId() = R.id.et password) í 
if (phone.length() > 0 && hasFocus = true) í 
UserInfo info = mHelper.queryByPhone(phone); 
if (info != null) { 
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et password.setText(info.password); 


} 
这 样 ， 就 不 再 需要 点 击 两 次 才 处 理 点 击 事件 了 。 
代码 写 完 后 ， 再 来 看 登录 页 面 的 效果 图 ， 用 户 上 次 登录 成 功 时 已 勾 选 “ 记 住 密码 ”， 现 
在 再 次 进入 登录 页 面 ,用户 输入 手机 号 后 光标 还 停留 在 手机 框 ， 如 图 4-8 所 示 。 接 着 点 击 密码 
框 ， 光 标 随 之 跳 到 密码 框 ， 这 时 密码 框 自动 填 入 了 该 手机 号 对 应 的 密码 串 ， 如 图 4-9 所 示 。 如 
此 便 真正 实现 了 记 住 密码 功能 。 





Storage 









O 验证 码 登录 


O 验证 码 登录 
我 是 ; 个 人 用 户 我 是 : 个 人 用 户 
手机 号 码 : 15960238696] 手机 号 码 : 15960238696 


登录 密码 : 忘记 密码 
记 住 密码 








图 4-8 ”光标 在 手机 号 码 框 图 4-9 光标 在 密码 输入 框 


43 SD 卡 文件 操作 


本 节 介 绍 Android 的 文件 存储 方式 一 一 SD 卡 的 用 法 ， 包 括 如 何 获取 Sp 卡 目录 信息 、 在 
SD 卡 上 读 写 文本 文件 、 在 SD 卡 读 写 图 片 文件 等 功能 。 


4.3.1 SD 卡 的 基本 操作 


手机 的 存储 空间 一 般 分 为 两 块 ， 一 块 用 于 内 部 存储 ， 另 一 块 用 于 外 部 存储 (SD F) 。 早 
期 的 SD 卡 是 可 插 拔 式 的 存储 芯片 ， 不 过 自己 买 的 SD 卡 质 量 参差 不 齐 , 经 常会 影响 App 的 正 
常 运行 ， 所 以 后 来 越 来 越 多 手机 把 SD 卡 固化 到 手机 内 部 ， 虽 然 拔 不 出 来 ， 但 是 Android 仍然 
称 之 为 外 部 存储 。 

获取 手机 上 的 SD 卡 信息 通过 Environment 类 实现 ,该 类 是 App 获取 各 种 目录 信息 的 工具 ， 
主要 方法 有 以 下 7 种 。 


e getRootDirectory: 获得 系统 根 目录 的 路 径 。 
e getDataDirectory: 获得 系统 数据 目录 的 路 径 。 
e getDownloadCacheDirectory: 获得 下 载 缓存 目录 的 路 径 。 
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e getExternalStorageDirectory: 获得 外 部 存储 (SDF) 的 路 径 。 


e getExternalStorageState: 获得 SD 卡 的 状态 。 




















状态 的 具体 取 值 说 明 见 表 4-1. 
表 4-1 SD 卡 的 存储 状态 取 值 说 明 

Environment 类 的 存储 状态 常量 名 常量 值 常量 说 明 
MEDIA UNKNOWN unknown 未 知 
MEDIA_REMOVED removed 已 经 移 除 
MEDIA_UNMOUNTED unmounted 未 挂 载 
MEDIA_CHECKING checking 正在 检查 
MEDIA NOFS nofs 不 支持 的 文件 系统 
MEDIA_MOUNTED mounted 已 经 挂 载 ， 且 是 可 读 写 状态 
MEDIA MOUNTED READ ONLY mounted ro 已 经 挂 载 ， 且 是 只 读 状 态 
MEDIA_SHARED shared 当前 未 挂 载 ， 但 通过 USB 共享 
MEDIA_BAD_REMOVAL bad removal 未 挂 载 就 被 移 除 
MEDIA_UNMOUNTABLE unmountable 无 法 挂 载 
MEDIA EJECTING ejecting 正在 弹出 





e getStorageState: 获得 指定 目录 的 状态 。 
e getExternalStoragePublicDirectory: 获得 SD 卡 指定 类 型 目录 的 路 径 。 


目录 类 型 的 具体 取 值 说 明 见 表 4-2。 
表 4-2 SD 卡 的 目录 类 型 取 值 说 明 

















Environment 类 的 目录 类 型 常量 值 常量 说 明 

DIRECTORY DCIM DCIM 相片 存放 目录 〈 包 括 相 机 拍摄 的 图 片 和 视频 ) 
DIRECTORY DOCUMENTS Documents 文档 存放 目录 

DIRECTORY DOWNLOADS Download 下 载 文件 存放 目录 

DIRECTORY MOVIES Movies 视频 存放 目录 

DIRECTORY MUSIC Music 音乐 存放 目录 

DIRECTORY PICTURES Pictures 图 片 存放 目录 





为 正常 操作 SD 卡 ， 需 要 在 AndroidManifest.xml 中 声明 SD 卡 的 权限 ， 具 体 代 码 如 下 : 


<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" > 
<uses-permission android:name-"android.permission READ EXTERNAL STORAG" /> 
<uses-permission android:name-"android.permission MOUNT UNMOUNT FILESYSTEMS" > 


下 面 演示 一 下 Environment 类 各 方法 的 使 用 效果 ， 如 图 4-10 所 示 。 页 面 上 展示 了 


Environment 类 获取 到 的 系统 及 SD 卡 的 相关 目录 信息 。 
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系统 环境 ( 含 SD 卡 ) 的 信息 如 下 : 

根 目录 路 径 : /system 

数据 目录 路 径 : /data 

下 载 缓存 目录 路 径 : /cache 

外 部 存储 ( 即 SD 卡 ) 目 录 路 径 : /storage/emulated/0 

外 部 存储 ( 即 SD 卡 ) 状 态 : mounted 

SD 卡 的 相机 目录 路 径 : /storage/emulated/0/DCIM 

SD 卡 的 下 载 目录 路 径 : /storage/emulated/0/ 
Download 

SD 卡 的 图 片 目录 路 径 : /storage/emulated/0/ 
Pictures 

SD 卡 的 视频 目录 路 径 : /storage/emulated/0/ 
Movies 

SD 卡 的 音乐 目录 路 径 : /storage/emulated/0/Music 














4-10 某 设备 上 的 SD 卡 目录 信息 
4.3.2 ”文本 文件 读 写 


文本 文件 的 读 写 一 般 借助 于 FileOutputStream 和 FileInputStream。 其 中 ，FileOutputStream 
用 于 写 文件 ，FileInputStream 用 于 读 文件 。 文 件 输出 输入 流 是 Java 语言 的 基础 工具 ， 这 里 不 
再 袭 述 ， 直 接 给 出 具体 的 实现 代码 : 
public static void saveText(String path, String txt) { 
try { 
FileOutputStream fos = new FileOutputStream(path); 
fos.write(txt.getBytes()); 
fos.close(); 
} catch (Exception e) { 
e.printStackTrace(); 


public static String openText(String path) í 
String readStr = ""; 
try ( 
FileInputStream fis — new FileInputStream(path); 
byte[] b = new byte[fis.available()]; 


fis.read(b); 
readStr = new String(b); 
fis.close(); 

} catch (Exception e) í 
e.printStack Trace(); 

; 

return readStr; 


n 
文本 文件 的 读 写 效果 如 图 4-11 Bras. App 把 页 面 录 入 的 注册 信息 保存 到 SD 卡 的 文本 文 





m 
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件 中 ,接着 进入 文件 列表 读 取 页 面 ， 选 中 某 个 文本 文件 ， 页 面 就 会 展示 该 文件 的 文本 内 容 ， 如 
图 4-12 所 示 。 








删除 所 有 文本 文件 


20161001183721.txt 


婚 否 : 已 婚 
注册 时 间 : 2016-10-01 18:37:21 


保存 文本 到 SD 卡 


用 户 注册 信息 文件 的 保存 路 径 为 : 
/storage/emulated/0/ 
Download/20161001183721.txt 











图 4-11 将 注册 信息 保存 到 文本 文件 图 4-12 从 文本 文件 读 取 注 册 信息 
4.3.3 图 片 文件 读 写 


Android 的 图 片 处 理 类 是 Bitmap，App 读 写 Bitmap 可 以 使 用 FileOutputStream 和 
FileInputStream。 不 过 在 实际 开发 中 ， 读 写 图 片 文 件 一 般 用 性 能 更 好 的 BufferedOutputStream 
和 BufferedInputStream 。 

保存 图 片 文件 时 用 到 Bitmap 的 compress 方法 ， 可 指定 图 片 类 型 和 压缩 质量 ; 打开 图 片 文 
件 时 使 用 BitmapFactory 的 decodeStream 方法 。 读 写 图 片 的 具体 代码 如 下 : 


public static void savelmage(String path, Bitmap bitmap) { 

try { 
BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(path)); 
bitmap.compress(Bitmap.CompressFormat.JPEG, 80, bos); 
bos.flush(); 
bos.close(); 

} catch (Exception e) í 
e.printStackTrace(); 


public static Bitmap openImage(String path) í 

Bitmap bitmap = null; 

uy ( 
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(path)); 
bitmap — BitmapFactory.decodeStream(bis); 
bis.close(); 

} catch (Exception e) í 
e.printStack Trace(); 
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return bitmap; 
; 
接 下 来 是 演示 时 间 ， 如 图 4-03 所 示 ， 用 户 在 注册 页 面 录入 注册 信息 ，App 调用 
getDrawingCache 方法 把 整个 注册 界面 截图 并 保存 到 SD F; 然后 在 另 一 个 页 面 的 图 片 列表 选 
# SD 卡 上 的 指定 图 片 文件 ， 页 面 就 会 展示 上 次 保存 的 注册 界面 图 片 ， 如 图 4-14 所 示 。 


删除 所 有 图 片 文件 


20161001183851.png 











未 婚 


保存 图 片 到 SD 卡 


用 户 注册 信息 图 片 的 保存 路 径 为 : 
/storage/emulated/0/ 
Download/20161001183851.png 





ma: 














4-13 保存 注册 信息 图 片 图 4-14 读 取 注册 信息 图 片 
刚才 从 SD 卡 读 取 图 片 文件 用 到 了 BitmapFactory 的 decodeStream 方 法 ,其 实 BitmapFactory 
还 提供 了 其 他 方法 ， 用 起 来 更 简单 、 方 便 ， 说 明 如 下 : 
e decodeFile: 该 方法 直接 传 文件 路 径 的 字符 串 ， 即 可 将 指定 路 径 的 图 片 读 取 到 Bitmap 对 象 。 
e decodeResource: 该 方法 可 从 资源 文件 中 读 取 图 片 信息 。 第 一 个 参数 一 般 传 
getResources()， 第 二 个 参数 传 drawable 图 片 的 资源 id， 如 R.drawable.phone。 


4.4 Application 基础 


本 节 介 绍 Android 重要 组 件 Application 的 基本 概念 和 常见 用 法 。 首 先 说 明 Application 的 
生命 周期 ， 接 着 利用 Application 的 持久 特性 实现 App 内 部 全 局 内 存 中 的 数据 保存 和 获取 。 


4.4.1 Application 的 生命 周期 


Application 是 Android 的 一 大 组 件 ， 在 App 运行 过 程 中 有 且 仅 有 一 个 Application 对 象 贯 
穿 整个 生命 周期 .打开 AndroidManifest.xml 时 会 发 现 activity 节点 的 上 级 正 是 application 节点 ， 
只 是 默认 的 application 节点 没有 指定 name 属性 ， 不 像 activity 节点 默认 指定 name 属性 值 
为 .MainActivity, 让 人 知晓 这 个 activity 的 入 口 代码 是 MainActivity.java。 现 在 我 们 给 application 
节点 加 上 name 属性 ， 看 看 其 庐山 真面目 。 


(1) 打开 AndroidManifest.xml， 给 application 节点 加 上 name 属性 ， 表 示 application 的 
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入 口 代码 是 MainApplication.java。 
android:name=".MainApplication" 
(2) 创建 MainApplication 25, 该 类 继承 自 Application, 可 以 重 写 的 方法 主要 有 以 下 4 个 。 


onCreate: 在 App 启动 时 调用 。 

onTerminate: 在 App 退出 时 调用 ( 按 字面 意思 ) 。 

onLowMemory: 在 低 内 存 时 调用 。 

onConfigurationChanged: 在 配置 改变 时 调用 ， 例 如 从 竖 屏 变 为 横 屏 。 


(3) 运行 App， 同 时 开启 日 志 的 打印 。 但 是 只 在 一 开始 看 到 MainApplication 的 onCreate 
HE CEF Activity 的 onCreate) ， 却 始终 无 法 看 到 它 的 onTerminate 操作 ， 无 论 是 自行 退出 
还 是 强行 杀 死 App 的 进程 ， 日 志 都 不 会 打印 onTerminate。 


信 不 信 ， 无 论 你 怎么 折腾 ， 这 个 onTerminate 都 不 会 出 来 。Android 明明 提供 了 这 个 函数 ， 
同时 提供 了 关于 该 函数 的 解释 ， 说 明文 字 如 下 : This method is for use in emulated process 
environments. It will never be called on a production Android device, where processes are removed 
by simply killing them; no user code (including this callback) is executed when doing so。 这 段 话 的 
意思 是 该 方法 是 供 模拟 环境 用 的 ,在 真 机 上 永远 不 会 被 调用 ,无 论 是 直接 杀 进 程 还 是 代码 退出 。 
现在 很 明确 了 ，onTerminate 方法 就 是 个 摆设 ， 中 看 不 中 用 。 如 果 读 者 想 在 App 退出 前 做 
资源 回收 操作 ， 那 么 千 万 不 要 放 在 onTerminate 方法 中 。 


44.2 利用 Application 操作 全 局 变量 


C/C++ 有 全 局 变量 ， 因 为 全 局 变量 保存 在 内 存 中 ， 所 以 操作 全 局 变量 就 是 操作 内 存 ， 内 存 
的 读 写 速度 远 比 读 写 数据 库 或 读 写 文件 快 得 多 。 全 局 的 意思 是 其 他 代码 都 可 以 引用 该 变量 , 因 
此 全 局 变量 是 共享 数据 和 消息 传递 的 好 帮手 。 不 过 ，Java 没有 全 局 变量 的 概念 。 与 之 比较 接 
近 的 是 类 里 面 的 静态 成 员 变 量 , 该 变量 可 被 外 部 直接 引用 , 并 且 在 不 同 地 方 引用 的 值 是 一 样 的 
(前 提 是 在 引用 期 间 不 能 修改 该 变量 的 值 ), 所 以 可 以 借助 静态 成 员 变 量 实现 类 似 全 局 变量 的 
功能 。 
前 面 花费 很 大 功夫 介绍 Application 的 生命 周期 ， 目 的 是 说 明 其 生命 周期 覆盖 App 运行 的 
全 过 程 。 不 像 短 暂 的 Activity 生命 周期 ， 只 要 进入 别 的 页 面 ， 原 页 面 就 被 停止 或 销毁 。 因 此 ， 
通过 利用 Application 的 持久 存在 性 可 以 在 Application 对 象 中 保存 全 局 变量 。 
适合 在 Application 中 保存 的 全 局 变量 主要 有 下 面 3 类 数据 : 
(1) 会 频繁 读 取 的 信息 ， 如 用 户 名 、 手 机 号 等 。 
(2) 从 网 络 上 获取 的 临时 数据 ， 为 节约 流量 、 减 少 用 户 等 待 时 间 ， 想 暂时 放 在 内 存 中 供 
下 次 使 用 ， 如 logo、 商 品 图 片 等 。 
(3) 容易 因 频 繁 分 配 内 存 而 导致 内 存 泄漏 的 对 象 ， 如 Handler 对 象 等 。 
要 想 通 过 Application 实现 全 局 内 存 的 读 写 ， 得 完成 以 下 3 项 工作 : 


CD 写 一 个 继承 自 Application 的 类 MainApplication。 该 类 要 采用 单 例 模式 ， 内 部 声明 自 
身 类 的 一 个 静态 成 员 对 象 ， 在 创建 App 时 把 自身 赋值 给 这 个 静态 对 象 ， 然 后 提供 该 静态 对 象 
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的 获取 方法 getInstance。 

(2) 在 Activity 中 调用 MainApplication 的 getInstance 方法 ， 获 得 MainApplication 的 一 
个 静态 对 象 ， 通 过 该 对 象 访问 MainApplication 的 公共 变量 和 公共 方法 。 

G) 不 要 忘 了 在 AndroidManifest.xml 中 注册 新 定义 的 Application 类 名 ， 即 在 application 
节点 中 增加 android:name 属性 ， 值 为 .MainApplication。 

下 面 继续 演示 全 局 内 存 的 读 写 效果 ， 如 图 4-15 所 示 。App 把 注册 信息 保存 到 

MainApplication 的 全 局 变量 中 ， 然 后 在 另 一 个 页 面 从 MainApplication 的 全 局 变量 中 读 取 保存 
好 的 注册 信息 ， 如 图 4-16 所 示 。 


Storage 









全 局 内 存 中 保存 的 信息 如 下 : 
married 的 取 值 为 未 婚 
weight 的 取 值 为 60 


: Xiaoming 


年 龄 : 18 height 的 取 值 为 170 
update_time 的 取 值 为 2016-10-03 12:13:49 
身高 170 age 的 取 值 为 18 
name 的 取 值 为 Xiaoming 
体重 : 60 
婚 否 : 未 婚 


保存 到 全 局 内 存 








4-15 注册 信息 保存 到 全 局 内 存 图 4-16 从 全 局 内 存 读 取 注 册 信息 
下 面 是 自 定 义 MainApplicaton 类 的 代码 : 
public class MainApplication extends Application í 
private static MainApplication mApp; 
public HashMap-String, String> mInfoMap = new HashMap<String, String>(); 


public static MainApplication getlnstance() í 
return mApp; 
} 


@Override 

public void onCreate() { 
super.onCreate(); 
mApp = this; 


} 


完成 以 上 编码 后 ，Activity 页 面 代码 即 可 直接 通过 MainApplication.getInstance().mInfoMap 
对 全 局 变量 进行 增 、 删 、 改 、 查 操作 。 
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4.5 KRMH: 购物 车 


购物 车 的 应 用 面 很 广 ， 凡 是 电 商 App 都 可 以 看 到 购物 车 的 身影 。 本 章 以 购物 车 为 实战 项 
目 , 除了 购物 车 使 用 广泛 的 特点 , 还 因为 购物 车 用 到 多 种 存储 方式 。 现 在 我 们 开启 购物 车 的 体 
验 之 旅 吧 ! 


4.5.1 设计 思 


先 来 看 常见 的 购物 车 的 外 观 。 第 一 次 进入 购物 车 频道 ， 购 物 车 里 面 是 空 的 ， 如 图 4-17 所 
示 。 接 着 去 商品 频道 选 购 手机 ， 随 便 挑 几 款 加 入 购物 车 ， 然 后 返回 购物 车 ， 即 可 看 到 购物 车 里 
的 商品 列表 ， 有 商品 图 片 、 名 称 、 数 量 、 单 价 、 总 价 等 信息 ， 如 图 4-18 所 示 。 











2499 4998 
哎呀 ， 购 物 车 空空 如 也 ， 快 去 选 购 商品 吧 

"uu iphone7 

6 . m 5888 5888 
aà 上 区 联通 电信 4G 手 机 
HEFND [ 小 米 5 

Sn 1799 1799 

@ vivo X6S 
i 1 2298 2298 

总 金额 : 14983 结 算 
图 4-17 空空 如 也 的 购物 车 图 4-18 购物 车 的 商品 列表 


购物 车 的 存在 感 很 强 ， 并 不 仅仅 在 购物 车 页 面 才能 看 到 。 往 往 在 商场 频道 ， 甚 至 某 个 商 
品 详情 页 面 ,都 会 看 到 某 个 角落 冒 出 一 个 购物 车 图 标 。 一 旦 有 新 商品 加 入 购物 车 ,购物 车 图 标 
上 的 商品 数量 就 立马 加 一 。 当 然 , 用 户 也 可 以 点 击 购物 车 图 标 直接 跳 转 到 购物 车 页 面 。 商 品 频 
道 除了 商品 列表 外 ,页 面 右上 角 还 有 一 个 购物 车 图 标 , 这 个 图 标 有 时 在 页 面 右上 角 , 有 时 又 在 
页 面 右 下 角 ， 如 图 4-19 所 示 。 商 品 详情 页 面 通常 也 有 购物 车 图 标 ， 如 果 用 户 在 详情 页 面 把 商 
品 加 入 购物 车 ， 那 么 图 标 上 的 数字 也 会 加 一 ， 如 图 4-20 所 示 。 

现在 我 们 来 看 购物 车 到 底 采 取 了 哪些 存储 方式 。 


e 数据 库 SQLite: 最 直观 的 是 数据 库 , 购物 车 里 的 商品 列表 一 定 放 在 SQLite F, 增删 改 查 
都 少不了 SQLite。 
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手机 商场 = 小 米 5 x 
iphone7 Mate8 4 ° F "m-— 
" dd š n 
C d | 
5888.0 加 入 购物 车 2499.0 加 入 购物 车 
小 米 5 Vivo X6S 
"- — 
Ü É "990 i 
sasa 小 米 手机 5 全 网 通 高 配 版 3GB 内 存 64GB 白色 
1799.0 加 入 购物 车 2298.0 加 入 购物 车 加 入 购物 车 
图 4-19 手机 商场 的 商品 列表 图 4-20 商品 详情 页 面 


e 共享 参数 SharedPreferences: 注意 不 同 页 面 的 右上 角 购 物 车 图 标 都 有 数字 ， 表 示 购 物 车 
中 的 商品 数量 ， 商 品 数量 建议 保存 在 共享 参数 中 。 因 为 每 个 页 面 都 要 显示 商品 数量 ， 如 
果 每 次 都 到 数据 库 中 执行 count 操作 ， 就 会 很 消耗 资源 。 因 为 商品 数量 需要 持久 地 存储 ， 
所 以 不 适合 放 在 全 局 内 存 中 ， 不 然 下 次 启动 App 时 ， 内 存 中 的 变量 又 从 0 开始 。 

e SD 卡 文件 : 通常 情况 下 ， 商 品 图 片 来 自 于 电 商 平台 的 服务 器 ， 这 年 头 流量 是 很 宝贵 的 ， 
可 是 图 片 恰恰 很 耗 流量 ( 尤其 是 大 图 ) 。 从 用 户 的 钱包 着 想 ，App 得 把 下 载 的 图 片 保存 
在 SD 卡 中 。 这 样 一 来 ， 下 次 用 户 访问 商品 详情 页 面 时 ，App 便 能 直接 从 SD 卡 获 取 商 品 
图 片 ， 不 但 不 花 流 量 而 且 加 快 浏览 速度 ， 一 举 两 得 。 

e 全 局 内 存 : 访问 SD 卡 的 图 片 文 件 固然 是 个 好 主意 ， 然 而 商品 频道 、 购 物 车 频道 等 可 能 
在 一 个 页 面 展示 多 张 商品 小 图 ， 如 果 每 张 小 图 都 要 访问 SD 卡 ， 频 繁 的 SD 卡 读 写 操作 
也 很 耗资 源 。 更 好 的 办 法 是 把 商品 小 图 加 载 进 全 局 内 存 ， 这 样 直接 从 内 存 中 获取 图 片 ， 
高 效 又 快速 。 之 所 以 不 把 商品 大 图 放 入 全 局 内 存 ， 是 因为 大 图 很 耗 空间 ， 一 不 小 心 就 会 
占用 几 十 兆 内 存 。 


不 找 不 知道 ， 一 找 吓 一 跳 ， 原 来 购物 车 用 到 了 这 么 多 种 存储 方式 。 
4.5.2 小 知识 : 菜单 Menu 


之 前 的 章节 在 进行 某 项 控制 操作 时 一 般 由 按钮 控件 触发 。 如 果 页 面 上 需要 支持 多 个 控制 
操作 ， 比 如 去 商场 购物 、 清 空 购物 车 、 查 看 商品 详情 、 删 除 指定 商品 等 ， 就 得 在 页 面 上 添加 多 
个 按钮 。 如 此 一 来 ，App 页 面 显得 杂乱 无 章 ， 满 屏 按钮 既 碍 眼 又 不 便 操作 。 这 时 ， 就 可 以 使 用 
菜单 控件 。 

菜单 无 论 在 哪里 都 是 常用 控件 ,Android 的 菜单 主要 分 两 种 ,一 种 是 选项 菜单 OptionMenu， 
通过 按 菜单 键 或 点 击 事件 触发 ， 对 应 Windows 上 的 开始 菜单 ; 另 一 种 是 上 下 文 菜单 
ContextMenu， 通 过 长 按 事件 触发 ， 对 应 Windows 上 的 右键 菜单 。 无 论 是 哪 种 菜单 ， 都 有 对 应 
的 菜单 布局 文件 ， 就 像 每 个 活动 页 面 都 有 一 个 布局 文件 一 样 。 不 同 的 是 页 面 的 布局 文件 放 在 
res/layout 目录 下 ， 菜 单 的 布局 文件 放 在 res/menu 目录 下 。 
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下 面 来 看 Android 的 选项 菜单 和 上 下 文 菜 单 。 
1. 选项 菜单 OptionMenu 
弹出 选项 菜单 的 途径 有 3 种 : 


(1) 按 菜 单 键 。 
COD 在 代码 中 手动 打开 选项 菜单 ， 即 调用 openOptionsMenu 方法 。 
G) 按 工具 栏 右 侧 的 溢出 菜单 按钮 ， 这 个 在 后 续 介 绍 工具 栏 时 进行 介绍 。 


实现 选项 菜单 的 功能 需要 重 写 以 下 两 种 方法 。 

e onCreateOptionsMenu: 在 页 面 打开 时 调用 。 需 要 指定 菜单 列表 的 XML 文件 。 

e onOptionsltemSelected: 在 列表 的 菜单 项 被 选中 时 调用 .。 需要 对 不 同 的 菜单 项 做 分 支 处 理 。 
下 面 是 菜单 布局 文件 的 代码 ， 很 简单 ， 就 是 menu 与 item 的 组 合 排列 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android" > 
<item 





android:id="(@+id/menu change time" 
android:orderInCategory-" | " 
android:title=" 改 变 时 间 "/> 

<item 
android:id="(@+id/menu change color" 
android:orderInCategory-"8" 
android:title=" 改 变 颜 色 "/> 

<item 
android:id="(@+id/menu change bg" 
android:orderInCategory-"9" 
android:title=" 改 变 背 景 "> 

</menu> 


接 下 来 是 使 用 选项 菜单 的 代码 片段 : 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.menu option, menu); 
return true; 


H 


@Override 
public boolean onOptionsltemSelected(Menultem item) í 
int id = item.getltemld(); 
if (id == R.id.menu_change time) í 
setRandomTime(); 
} else if (id — R.id.menu change color) í 
tv option.setTextColor(getRandomColor()); 
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} else if (id = R.id.menu change bg) í 
tv_option.setBackgroundColor(getRandomColor()); 
; 
return true; 
} 


private void setRandomTime() í 
String desc = DateUtil.getNowDateTime("yyyy-MM-dd HH:mm:ss") + ”这 里 是 菜单 显示 文本 "; 
tv option.setText(desc); 

b 


private int[] mColorArray = í 
Color.BLACK, Color. WHITE, Color.RED, Color. Y ELLOW, Color.GREEN, 
Color.BLUE, Color.CYAN, Color. MAGENTA, Color.GRAY, Color. DKGRAY }; 
private int getRandomColor() í 
int random = (int) (Math.random()*10 % 10); 
return mColorArray [random]; 
); 


按 菜 单 键 和 调用 openOptionsMenu 方法 弹出 的 选项 菜单 都 是 在 页 面 下 方 , 如 图 4-21 所 示 。 
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2. 上 下 文 菜单 ContextMenu 
弹出 上 下 文 菜单 的 途径 有 两 种 : 

(1) 默认 在 某 个 控件 被 长 按时 弹出 。 通 常 在 onStart 函数 中 加 入 registerForContextMenu 
方法 为 指定 控件 注册 上 下 文 菜单 , 在 onStop 函数 中 加 入 unregisterForContextMenu 方法 为 指定 
控件 注销 上 下 文 菜单 。 

(2) 在 除 长 按 事 件 之 外 的 其 他 事件 中 打开 上 下 文 菜单 。 先 执行 registerForContextMenu 
方法 注册 菜单 , 然后 执行 openContextMenu 方法 打开 菜单 , 最 后 执行 unregisterForContextMenu 
方法 注销 菜单 。 

实现 上 下 文 菜单 的 功能 需要 重 写 以 下 两 种 方法 。 
e onCreateContextMenu: 在 此 指定 菜单 列表 的 XML 文件 ， 作 为 上 下 文 菜单 列表 项 的 来 源 。 
e onContextltemSelected: 在 此 对 不 同 的 菜单 项 做 分 支 处 理 。 


上 下 文 菜单 的 布局 文件 格式 同 选项 菜单 ， 下 面 是 使 用 上 下 文 菜单 的 代码 片段 : 
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@Override 

protected void onResume() í 
registerForContextMenu(tv_context); 
super.onResume(); 

h 


(@Override 

protected void onPause() í 
unregisterForContextMenu(tv_context); 
super.onPause(); 

1 


(@Override 

public void onCreateContextMenu(ContextMenu menu, View v, ContextMenulnfo menulnfo) { 
getMenulnflater().inflate(R.menu.menu option, menu); 

1 


(@Override 
public boolean onContextltemSelected(Menultem item) í 
int id = item.getltemld(); 
if (id == R.id.menu_change time) í 
setRandomTime(); 
} else if (id == R.id.menu change color) í 
tv context.setTextColor(getRandomColor()); 
) else if (id = R.id.menu change bg) í 
tv context.setBackgroundColor(getRandomColor()); 
] 
return true; 


j 
上 下 文 菜单 的 菜单 列表 固定 显示 在 页 面 中 部 ， 菜 单 外 的 其 他 页 面 区 域 颜色 会 变 深 ， 具 体 
效果 如 图 4-22 所 示 。 
改变 时 间 
改变 颜色 


改变 背景 





图 422 上 下 文 菜单 的 菜单 列表 
4.5.3 ”代码 示例 


这 一 章 的 编码 开始 有 些 复杂 了 ， 不 但 有 各 种 控件 和 布局 的 操作 ， 还 有 4 种 存储 方式 的 使 
目 ， 再 加 上 Activity 与 Application 两 大 组 件 的 运用 ， 已 然 是 一 个 正规 App 的 雏形 。 
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编码 过 程 分 为 4 步 〈 增 加 的 一 步 是 对 AndroidManifest.xml 认真 配置 ) : 

ED 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 购物 车 页 面 的 代码 文件 取 名 
ShoppingCartActivityjava， 对 应 的 布局 文件 名 是 activity shopping cartxml; 商场 频道 页 面 的 代码 文件 
取 名 ShoppingChannelActivityjava, 对 应 的 布局 文件 名 是 activity shopping channelxml; 商品 详情 页 面 
的 代码 文件 取 名 ShoppingDetailActivity， 对 应 的 布局 文件 名 是 activity shopping detaixml; 另 有 一 个 
全 局 应 用 的 代码 文件 MainApplication.java. 

C302 在 AndroidManifestxml 中 补充 相应 配置 ， 主 要 有 以 下 3 A: 


(1) 注册 3 个 页 面 的 acitivity 节点 ， 注 册 代码 如 下 : 





























«activity android:name=".ShoppingCartActivity" android:theme-"(g'style/AppBaseTheme" /> 
«activity android:name=".ShoppingChannelActivity" /> 
<activity android:name=".ShoppingDetailActivity" /> 

(2) 给 application 补充 name 属性 ， 值 为 MainApplication， 举 例如 下 : 
android:name=".MainApplication" 

(3) 声明 SD 卡 的 操作 权限 ， 主 要 补充 下 面 3 行 权限 配置 : 


<uses-permission android:name-"android.permission. WRITE EXTERNAL STORAGE" /> 
«uses-permission android:name-"android.permission READ EXTERNAL STORAG" /> 
«uses-permission android:name-"android.permission MOUNT UNMOUNT FILESYSTEMS" /> 


EI res 目录 下 的 XML 文件 编写 也 多 了 起 来 ， 主 要 工作 包括 : 


(1) 在 res/layout 目录 下 创建 布局 文件 activity_shopping_cart.xml、 activity_shopping_channel.xml、 
activity_shopping_detail.xml， 分 别 根据 页 面 效 果 图 编写 3 个 页 面 的 布局 定义 文件 。 

(2) 在 res/menu 目录 下 创建 菜单 布局 文件 menu_cart.xml 和 menu_goods.xml， 分 别 用 于 购物 车 
的 选项 菜单 和 商品 项 的 上 下 文 菜单 。 

(3) 在 values/styles.xml 中 补充 下 面 的 样式 定义 ， 给 不 带 导 航 栏 的 购物 车 页 面 使 


<style name-"AppBaseTheme" parent="Theme.AppCompat.Light" /> 


E 在 项 目的 包 名 目录 下 创建 类 MainApplication、ShoppingCartActivity、ShoppingChannel- 
Activity 和 ShoppingDetailActivity， 并 填 入 具体 的 控件 操作 与 业务 逻辑 代码 。 


下 面 是 购物 车 页 面 ShoppingCartActivity.java 的 主要 代码 片段 : 


@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
request WindowFeature(Window.FEATURE NO. TITLE); 
setContentView(R.layout.activity shopping cart); 
iv menu = (ImageView) findViewById(R.id.iv menu); 
tv title = (TextView) find ViewById(R.id.tv title); 
tv count = (TextView) find ViewById(R.id.tv count); 
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tv total price = (TextView) findViewById(R.id.tv total price); 

Il content = (LinearLayout) findViewById(R.id.ll content); 

Il cart = (LinearLayout) find ViewById(R.id.ll cart); 

Il empty = (LinearLayout) find ViewById(R.id.ll empty); 

iv menu.setOnClickListener(this); 
findViewByld(R.id.btn shopping channel).setOnClickL istener(this); 
findViewByld(R.id.btn settle).setOnClickListener(this); 

iv menu.setVisibility(View. VISIBLE); 

tv. title.setText(" HHE"); 

mCount = Integer.parseInt(SharedUtil. getIntance(this).readShared("count", "0")); 
showCount(mCount); 


// 显 示 购物 车 图 标 中 的 商品 数量 
private void showCount(int count) { 
mCount = count; 
tv count.setText(""--mCount); 
if (mCount == 0) í 
ll content.setVisibility(View. GONE); 
ll cart.removeAllViews(); 
ll empty.setVisibility(View. VISIBLE); 
} else ( 
Il content.setVisibility(View. VISIBLE); 
lI empty.setVisibility(View. GONE); 


(@Override 
public void onClick(View v) í 
if (v.getId() == R.id.iv menu) { 
openOptionsMenu(); 
} else if (v.getId() = R.id.btn shopping channel) í 
Intent intent = new Intent(this, ShoppingChannelActivity.class); 
startActivity(intent); 
} else if (v.getId() = R.id.btn settle) í 
AlertDialog.Builder builder = new AlertDialog.Builder(this ); 
builder.setTitle(" 结 算 商 品 "); 
builder setMessage(" 客 官 抱 欢 ， 支 付 功能 尚未 开通 ， 请 下 次 再 来 "); 
builder.setPositiveButton(" 我 知道 了 ", null); 
builder.create().show(): 
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@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.menu_cart, menu); 
return true; 


@Override 
public boolean onOptionsItemSelected(Menultem item) { 
int id = item.getItemId(); 
if (id == R.id.menu_shopping) í 
Intent intent = new Intent(this, ShoppingChannelActivity.class); 
startActivity(intent); 
} else if (id = R.id.menu clear) í 
/清空 购物 车 数据 库 
mCartHelper.deleteAll(); 
ll cart.removeAllViews(); 
SharedUtil.getIntance(this).writeShared(" count", "0"); 
showCount(0); 
mGoodsView.clear(); 
mGoodsMap.clear(); 
Toast.makeText(this, "购物 车 已 清空 ", Toast.LENGTH. SHORT ).show(); 
) else if (id — R.id.menu retum) í 
finish(); 
J 


return true; 


private HashMap-Integer, Long» mGoodsView = new HashMap-Integer, Long>(); 

private View mContextView; 

(@Override 

public void onCreateContextMenu(ContextMenu menu, View v, ContextMenulnfo menulnfo) í 
mContextView = v; 
getMenulnflater().inflate(R.menu.menu_goods, menu); 


(@Override 
public boolean onContextltemSelected(Menultem item) í 
int id = item.getltemld(); 
if (id == R.id.menu_detail) í 
// 跳 转 到 查看 商品 详情 页 面 
goDetail(mGoodsView.get(mContextView.getld())); 
} else if (id = R.id.menu delete) í 
// 从 购物 车 删除 商品 的 数据 库 操作 
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long goods id = mGoodsView.get(mContextView.getld()); 
mcCartHelper.delete("goods id="+goods id); 
ll cart.removeView(mContextView); 
/更 新 购物 车 中 的 商品 数量 
int left count = mCount-1; 
for (int i=0; i<mCartArray.size(); i++) { 
if (goods id == mCartArray.get(i).goods_id) í 
left count = mCount-mCartArray.get(i).count; 
mCartArray.remove(i); 
break; 


j 

SharedUtil.getIntance(this).writeShared("count", "left count); 

showCount(left count); 

Toast.makeText(this, "已 从 购物 车 删除 "+mGoodsMap.get(goods_id).name, 
Toast.LENGTH_SHORT).show(); 

mGoodsMap.remove(goods id); 

refreshTotalPrice(); 

i 


return true; 


private void goDetail(long rowid) í 
Intent intent — new Intent(this, ShoppingDetailActivity.class); 
intent.putExtra("goods id", rowid); 
startActivity(intent); 


private GoodsDBHelper mGoodsHelper; 

private CartDBHelper mCartHelper; 

private String mFirst — "true"; 

@Override 

protected void onResume() { 
super.onResume(); 
mGoodsHelper = GoodsDBHelper.getInstance(this, 1); 
mGoodsHelper.openWriteLink(); 
mCartHelper = CartDBHelper.getInstance(this, 1); 
mCartHelper.openWriteLink(); 
mFirst = SharedUtil.getIntance(this).readShared("first", "true"); 
downloadGoods(); 
SharedUtil.getIntance(this).writeShared("first", "false"); 
showCart(); 
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@Override 

protected void onPause() { 
super.onPause(); 
mGoodsHelper.closeLink(); 
mCartHelper.closeLink(); 


// 模 拟 网 络 数据 ， 初 始 化 数据 库 中 的 商品 信息 
private void downloadGoods() { 
String path = Environment.getExternalStoragePublicDirectory(Environment. DIRECTORY _ 
DOWNLOADS)+"/"; 
if (mFirst.equals("true")) í 
for (int i=0; i<mNameArray.length; i++) í 
GoodslInfo info = new GoodsInfo(); 
info.name = mNameArray[i]; 
info.desc = mDescArray[i]; 
info.price — mPriceArray[i]; 
long rowid = mGoodsHelper.insert(info); 
info.rowid = rowid; 
// 往 全 局 内 存 写 入 商品 小 图 
Bitmap thumb = BitmapFactory.decodeResource(getResources(), mThumbArray[i]); 
MainApplication.getInstance().mIconMap.put(rowid, thumb); 
String thumb path = path + rowid + " s.jpg": 
FileUtil.saveImage(thumb path, thumb); 
info.thumb path = thumb path; 
// 往 SD 卡 保存 商品 大 图 
Bitmap pic = BitmapFactory.decodeResource(getResources(), mPicArray[i]); 
String pic path = path + rowid + " jpg"; 
FileUtil.savelmage(pic_path. pic); 
pic.recycle(); 
info.pic path — pic path; 
mGoodsHelper.update(info); 
j 
} else í 
ArrayList<GoodsInfo> goodsArray = mGoodsHelper.query(" 171"); 
for (int i=0; i-goodsArray.size(); i++) í 
GoodsInfo info = goodsArray.get(i); 
Bitmap thumb = BitmapFactory.decodeFile(info.thumb path); 
MainApplication.getInstance().mIconMap.put(info.rowid, thumb); 
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46 小 结 


本 章 主要 介绍 了 Android 常用 的 几 种 数据 存储 方式 , 包括 共享 参数 SharedPreferences 的 键 
值 对 存 取 、 数 据 库 SQLite 的 关系 型 数据 存 取 、SD 卡 的 文件 写 入 与 读 取 操作 ( 含 文本 文件 读 写 
和 图 片 文件 读 写 ) 、App 全 局 内 存 的 读 写 以 及 为 实现 全 局 内 存 而 学 习 的 Application 组 件 的 生 
命 周 期 及 其 用 法 。 最 后 设计 了 一 个 实战 项 目 “ 购 物 车 ”, 通过 该 项 目的 编码 进一步 复习 巩固 本 
章 4 种 存储 方式 的 使 用 ， 另 外 介绍 了 选项 菜单 和 上 下 文 菜单 的 基本 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 3 种 开发 技能 : 

CD 学 会 共享 参数 SharedPreferences、 数 据 库 SQLite. SD 卡 文件 、 全 局 内 存 4 种 存储 方 
式 的 用 法 。 

(2) 学 会 Application 组 件 的 用 法 。 

(3) 学 会 选项 菜单 和 上 下 文 菜单 的 基本 用 法 。 


ETE 





TES ausu 


本 章 介 绍 App 开发 常用 的 一 些 高 级 控件 及 相关 工具 ， 
主要 包括 日 期 时 间 控件 的 用 法 、 列 表 类 视图 及 其 适配器 的 用 
法 、 翻 页 类 视图 及 其 适配器 的 用 法 、 碎片 及 其 适配器 的 用 法 
等 ， 另 外 介绍 四 大 组 件 之 一 Broadcast 的 基本 概念 与 常见 用 
法 。 最 后 结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 日 历 /日 
程 表 ”的 设计 与 实现 。 





Ea M 
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5.4 日 期 时 间 控 件 


本 节 介绍 Android 的 日 期 时 间 控 件 ， 主 要 是 日 期 选择 对 话 框 DatePickerDialog 和 时 间 选 择 
对 话 框 TimePickerDialog 的 用 法 。 


5.1.1 日 期 选择 器 DatePicker 


虽然 EditText 控件 提供 inputType="date" 的 日 期 输入 ， 但 是 很 少 有 用 户 会 老 老实 实地 手工 
输入 日 期 , 况且 EditText 还 不 支持 “**** 年 ** 月 ** 日 ”这 样 的 日 期 格式 ， 所 以 都 要 系统 提供 日 
期 控件 ， 供 用 户 选择 具体 的 年 月 日 ， 在 Android 中 这 个 控件 是 DatePicker。 不 过 ，DatePicker 
并 非 弹 窗 模式 , 而 是 直接 在 页 面 上 占据 一 块 区 域 ,并且 不 会 自动 关闭 。 按 习惯 来 说 ,日 期 控件 
应 该 在 当前 页 面 弹 出 ， 选 择 完 日 期 就 要 把 控件 关 掉 。 因 此 ，DatePicker 不 适合 直接 使 用 ， 实 际 
开发 中 用 的 是 已 经 封装 好 的 日 期 选择 对 话 框 DatePickerDialog。 

DatePickerDialog 相当 于 在 AlertDialog 上 加 载 了 DatePicker， 用 起 来 更 简单 ， 只 需 调用 构 
造 函 数 设 置 一 下 当前 年 、 月 、 日 ， 然 后 调用 show 方法 即 
可 弹出 日 期 对 话 框 。 日 期 选择 事件 由 监听 器 2016-10-6 周 四 
OnDateSetListener 负责 响应 ， 在 该 监听 器 实现 的 
onDateSet 方 法 中 ,开发 者 能 够 获得 用 户 选择 的 具体 日 期 ， 
并 做 后 续 处 理 。 这 里 要 特别 注意 onDateSet 方法 的 月 份 参 
数 ， 该 参数 的 起 始 值 不 是 1 而 是 0。 也 就 是 说 ， 一 月 份 对 
应 的 参数 数值 是 0， 十 二 月 份 对 应 的 参数 数值 是 11。 如 
果实 在 不 理解 ， 记 住 这 里 的 月 份 值 要 加 1 就 行 了 。 

图 5-1 所 示 为 一 个 默认 样式 的 日 期 选择 对 话 框 。 其 
rh, 年 、 月 、 日 通过 上 下 滑动 选择 。 图 5-1 日 期 选择 对 话 杠 

下 面 是 使 用 日 期 对 话 框 的 代码 : 

public class DatePickerActivity extends AppCompatActivity implements OnClickListener, 
OnDateSetListener í 

private TextView tv_date; 








(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity date picker); 
tv. date = (TextView) find ViewById(R.id.tv. date); 
findViewByld(R.id.btn date).setOnClickListener(this); 

h: 


@Ovemide 
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public void onClick(View v) í 
if (v.getId() = R.id.btn date) { 

Calendar calendar = Calendar getInstance(); 

DatePickerDialog dialog = new DatePickerDialog(this, this, 
calendar.get(Calendar. Y EAR), calendar.get(Calendar. MONTH), 
calendar.get(Calenda.DAY OF MONTH)); 

dialog.show(); 


i 


(a Override 
public void onDateSet(DatePicker view, int year, int monthOfYear, int dayOfMonth) í 
String desc = String.format(" 您 选择 的 日 期 是 %d 年 %d 月 %d H", 
year, monthOfYear+1, dayOfMonth); 
tv. date.setText(desc); 


H 
54.2 ”时 间 选 择 器 TimePicker 


有 了 日 期 选择 器 ， 肯 定 有 对 应 的 时 间 选 择 器 。 同 样 ， 实 际 开发 中 也 不 直接 用 TimePicker, 
而 是 用 封装 好 的 时 间 选 择 对 话 框 TimePickerDialog。 该 对 话 框 的 用 法 类 似 DatePickerDialog， 
不 同 之 处 主要 有 两 个 : 

CD 构造 函数 传 的 是 当前 的 小 时 与 分 钟 ， 最 后 一 
个 参数 表示 是 否 采 用 二 十 四 小 时 制 ， 一 般 传 tue， 表 
示 小 时 的 数值 范围 为 0 一 23 。 

(2) 时 间 选 择 监听 器 是 OnTimeSetListener， 对 应 
需要 实现 的 方法 是 onTimeSet, 在 该 方法 中 可 获得 用 户 
选 好 的 小 时 和 分 钟 。 

图 5-2 所 示 为 一 个 默认 样式 的 时 间 选 择 对 话 框 。 
其 中 ， 小 时 与 分 钟 可 通过 上 下 滑动 选择 。 





下 面 是 使 用 时 间 对 话 框 的 代码 : 图 5-2 ”时 间 选 择 对 话 框 
public class TimePickerActivity extends AppCompatActivity implements OnClickListener, 
OnTimeSetListener { 


private TextView tv time; 


@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity time picker); 
tv time = (TextView) findViewById(R.id.tv time); 
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findViewByld(R.id.btn time).setOnClickListener(this); 
} 


@Override 
public void onClick(View v) { 
if (v.getld() = R.id.btn time) í 
Calendar calendar = Calendar.getInstance(); 
TimePickerDialog dialog = new TimePickerDialog(this, this, 
calendar.get(Calendar HOUR OF DAY), calendar.get(Calendar.MINUTE), 


dialog.show(); 


j 


@Override 

public void onTimeSet(TimePicker view, int hourOfDay, int minute) { 
String desc = String.format(" 您 选择 的 时 间 是 %d 时 %d 分 " hourOfDay, minute); 
tv_time.setText(desc); 


5.2 “列表 类 视图 


本 节 介绍 列表 类 视图 怎样 结合 基本 适配器 实现 视图 展示 的 效果 ， 包 括 基 本 适配器 
BaseAdapter 的 用 法 、 列 表 视 图 ListView 的 分 隔 线 设置 与 使 用 注意 点 、 网 格 视图 GridView 的 
分 隔 线 设置 与 使 用 注意 点 。 


5.2.1 基本 适配器 BaseAdapter 


第 3 童 介绍 下 拉 框 Spinner 时 提 到 该 控件 可 使 用 ArrayAdapter 和 SimpleAdapter 两 种 适 配 
器 。 其 中 ，ArrayAdapter 适用 于 纯 文本 的 列表 数据 ，SimpleAdapter 适用 于 带 图 标的 列表 数据 。 
实际 应 用 中 常常 有 更 复杂 的 列表 , 比如 同一 项 中 存在 多 个 控件 , 这 种 情况 即使 用 SimpleAdapter 
也 很 吃力 , 而 且 不 易 扩展 。 基 于 此 , Android 提供 了 一 种 适应 性 更 强 的 基本 适配器 BaseAdapter, 
该 适配器 允许 开发 者 在 别 的 代码 文件 中 进行 逻辑 处 理 ， 大 大 提高 了 代码 的 可 读 性 和 可 维护 性 。 

从 BaseAdapter 派生 的 数据 适配器 主要 实现 下 面 3 个 方法 。 

e 构造 函数 : 指定 适配器 需要 处 理 的 数据 集合 。 

e getCount: 获取 数据 项 的 个 数 。 

e getView: 获取 每 项 的 展示 视图 ， 并 对 每 项 的 内 部 控件 进行 业务 处 理 。 


下 面 以 Spinner 控件 为 载体 ， 演 示 如 何 操作 BaseAdapter， 具 体 的 编码 分 为 3 步 : 
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ED 编写 列表 项 的 布局 文件 ， 示 例 代码 如 下 : 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:id="(@+id/ll item" 
android:layout width="match parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" > 


*ImageView 
android:id-"(g)*id/iv icon" 
android:layout width-"Odp" 
android:layout height-"8O0dp" 
android:layout weight-"1" 
android:scaleType-"fitCenter" /> 


*LinearLayout 
android:layout width-"Odp" 
android:layout height-"match parent" 
android:layout weight-"3" 
android:orientation-" vertical" > 


«TextView 
android:id-"(g)*id/tv name" 
android:layout width-"match parent" 
android:layout height-"Odp" 
android:layout weight-"1" 
android:gravity-"left|center" 
android:textColor="(@color/black" 
android:textSize="20sp" /> 


<TextView 
android:id="@+id/tv_desc" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="2" 
android:gravity="left|center" 
android:textColor="(@color/black" 
android:textSize="13sp" /> 
</LinearLayout> 
</LinearLayout> 


EI 写 个 新 的 适配器 继承 BaseAdapter， 实 现 对 列表 项 视图 的 获取 与 操作 ， 示 例 代码 如 下 : 
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public class PlanetAdapter extends BaseAdapter í 
private LayoutInflater mlnflater; 
private Context mContext; 
private int mLayoutld; 
private ArrayList<Planet> mPlanetList; 
private int mBackground; 


public PlanetAdapter(Context context, int layout id, ArrayList<Planet> planet list, int background) { 
mlnflater = LayoutlInflater.from(context); 
mContext = context; 
mLayoutld = layout id; 
mPlanetList = planet list; 
mBackground = background; 


@Override 
public int getCount() { 
return mPlanetList.size(); 


@Override 
public Object getItem(int arg0) { 
return mPlanetList.get(arg0); 


@Override 
public long getltemld(int arg0) í 
return arg; 


@Override 
public View getView(final int position, View convertView, ViewGroup parent) { 
ViewHolder holder = null; 
if (convertView = null) { 
holder = new ViewHolder(); 
convertView = minflater.inflate(mLayoutld, null); 
holder.ll item = (LinearLayout) convertView.find ViewById(R.id.ll item); 
holderiv icon = (ImageView) convertView.findViewByld(R.id.iv icon); 
holdertv name = (TextView) convertView.findViewById(R.id.tv name); 
holdertv desc = (TextView) convertView.findViewByld(R.id.tv desc); 
convertView.setTag(holder); 
} else í 
holder = (ViewHolder) convertView.getTag(); 
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J 

Planet planet = mPlanetList.get(position); 

holder.ll item.setBackgroundColor(mBackground); 
holder.iv icon.setImageResource(planet.image); 
holder.tv name.setText(planet.name); 

holder.tv desc.setText(planet.desc); 

return convertView; 


public final class ViewHolder í 
private LinearLayout ll. item; 
public ImageView iv icon; 
public TextView tv name; 
public TextView tv. desc; 


1 
Eo 在 页 面 代码 中 构造 该 适配器 ， 并 应 用 于 Spinner 对 象 ， 示 例 代码 如 下 : 

















private void initSpinner() í 
planetList = Planet.getDefaultList(); 
Planet Adapter adapter = new PlanetAdapter(this, R.layout.item list, planetList, Color. WHITE); 
Spinner sp = (Spinner) findViewById(R.id.sp planet); 
sp.setPrompt(" 请 选择 行星 "); 
sp.setAdapter(adapter); 
sp.setSelection(0); 
sp.setOnltemSelectedListener(new MySelectedListener()); 


private class MySelectedListener implements OnItemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) { 
Toast.makeText(BaseAdapterActivity.this, "您 选择 的 是 "+planetList.get(arg2).name， 
Toast. LENGTH_LONG).show(); 


j 


public void onNothingSelected(AdapterView-?- arg0) í 


1 
1 


具体 的 列表 对 话 框 效果 如 图 5-3 所 示 。 可 以 看 到 ， 每 行 左边 是 行星 图 标 ， 右边 的 上 面 是 行 
星 名 称 ， 下 面 是 行星 的 描述 。 因 为 对 列表 项 布局 item_listxml 使 用 了 单独 的 适配器 代码 
PlanetAdapter， 所 以 再 多 加 几 个 控件 也 不 怕 麻 烦 了 。 
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水 星 


水 星 是 太阳 系 八 大 行星 最 内 侧 也 是 最 小 的 一 糯 行 | 
星 ,也 是 高 太阳 最 近 的 行星 


金星 


金星 是 太阳 系 八 大 行星 之 一 ,排行 第 二 ， 距 离 太 | 
阳 0.725 天 文 单位 


地 球 
和 ,排行 第 三 


质量 和 密度 最 大 的 类 地 行星 ， W^ 
太阳 1.5 亿 公 


火星 是 太阳 系 八大 行星 之 一 ， 排行 第 四 ,属于 类 
地 行星 ,直径 约 为 地 球 的 53% 


木星 

TRRARRAACEOAREA. BuU 
SE. 排行 第 五 。 它 的 质量 为 太阳 的 千 分 

D SRRRRRCCAGEREOR 
土星 


土星 为 太阳 系 八大 行星 之 一 ， 排 行 第 六 ,体积 仅 
次 于 木星 





图 5-3 下 拉 列 表 中 的 基本 适配器 效果 
52.2 ”列表 视图 ListView 


前 面 我 们 给 Spinner 控件 加 上 了 基本 适配器 ， 然 而 — emm 
列表 效果 只 在 弹出 对 话 框 中 展示 ， 一 旦 选中 某 项 ， 回 到 
页 面 时 又 只 显示 选中 的 内 容 ， 如 图 5-4 所 示 。 水 是 

这 么 丰富 的 列表 信息 没 展示 在 页 面 上 实在 是 可 惜 ， g: A 
也 许 用 户 对 好 几 项 内 容 都 感 兴趣 。 如 果 想 在 页 面 上 直接 
显示 全 部 列表 信息 ， 就 要 引入 新 的 列表 视图 ListView。 图 5-4 下 拉 框 在 页 面 上 只 显示 一 行 
ListView 允许 在 页 面 上 分 行 展 示 相 似 的 数据 界面 ， 如 新 闻 列表 、 商 品 列表 、 书 籍 列表 等 ， 方 便 
用 户 逐 行 浏览 与 操作 。 列 表 视图 ListView 新 增 的 属性 与 方法 说 明 见 表 5-1。 


行星 的 网 格 视图 





表 5-1 ListView 的 属性 与 方法 说 明 








XML 中 的 属性 ListView 类 的 设置 方法 “| 说 明 








divider setDivider 指定 分 隔 线 的 图 形 。 如 需 取消 分 隔 线 ， 可 设置 该 属性 值 
为 @null 
dividerHeight | setDividerHeight 指定 分 隔 线 的 高 度 





headerDividersEnabled | setHeaderDividersEnabled | 指定 是 否 显示 列表 开头 的 分 隔 线 
footerDividersEnabled | setFooterDividersEnabled | 指定 是 否 显示 列表 末尾 的 分 隔 线 





另外 ，ListView 实现 了 3 个 与 适配器 相关 的 方法 。 


e setAdapter: 设置 列表 项 的 数据 适配器 ， 适 配器 一 般 继承 BaseAdapter。 
e setOnltemClickListener: 设置 列表 项 的 点 击 事件 监听 器 OnItemClickListener。 
e setOnltemLongClickListener: 设置 列表 项 的 长 按 事 件 监听 器 OnItemLongClickListener。 


下 面 是 列表 项 处 理 点 击 事 件 和 长 按 事 件 的 代码 : 








Android Studio 开交 实战 : JE SER] App 上 线 





@Override 
public void onltemClick(AdapterView<?> parent, View view, int position, long id) í 
String desc = String.format(" 您 点 击 了 第 %d 个 行星 ， 它 的 名 字 是 %s", position + 1, 
mPlanetList.get(position).name); 
Toast.makeText(mContext, desc, Toas.LENGTH LONG ).show(); 


@Override 
public boolean onltemLongClick(AdapterView<?> parent, View view, int position, long id) í 
String desc = String.format(" 您 长 按 了 第 %d 个 行星 ， 它 的 名 字 是 %s", position + 1, 
mPlanetList.get(position).name); 
Toast.makeText(mContext, desc, Toast.LENGTH LONG).show(); 
return true; 


j 


光 看 这 些 文字 会 觉得 ListView 是 个 加 强 版 的 Spinner， 不 但 可 以 直接 在 页 面 上 展示 列表 ， 
而 且 能 设置 分 隔 线 与 点 击 监 听 器 。 事 实 上 ，ListView 很 令 人 头痛 ， 使 用 过 程 中 经 常 出 现 意 想 不 
到 的 状况 ， 比 如 分 隔 线 就 容易 出 状况 ， 下 面 演示 分 隔 线 的 测试 代码 片段 : 

private class DividerSelectedListener implements OnItemSelectedListener { 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) { 
LinearLayout.LayoutParams params — new LinearLayout.LayoutParams( 
LayoutParams.MATCH PARENT, LayoutParams. WRAP CONTENT); 
lv planet.setDivider(drawable); 
lv planet.setDividerHeight(dividerHeight); 
lv planet.setPadding(0, 0, 0, 0); 
lv planet.setBackgroundColor(Color. TRANSPARENT); 
if(arg2 — 0) í / 不 显示 分 隔 线 (分 隔 线 高 度 为 0) 
lv planet.setDividerHeight(0); 
} elseif(arg2 — 1) (. // 不 显示 分 隔 线 (分 隔 线 为 nulD 
lv planet.setDivider(null); 
lv planet.setDividerHeight(dividerHeight); 
} else if (arg? 一 2){ // 只 显示 内 部 分 隔 线 ( 先 设置 分 隔 线 高 度 ) 
lv planet.setDividerHeight(dividerHeight); 
lv planet.setDivider(drawable); 
} else if (arg2 一 3){ // 只 显示 内 部 分 隔 线 (后 设置 分 隔 线 高 度 ) 
lv planet.setDivider(drawable); 
lv planet.setDividerHeight(dividerHeight); 
} else if(arg2 一 4){ / 显示 底部 分 隔 线 (高 度 是 wrap content) 
lv planet.setFooterDividersEnabled(true); 
} else if(arg2 = 5) { // 显示 底部 分 隔 线 (高 度 是 match parent) 
params = new LinearLayout.LayoutParams(LayoutParams.MATCH PARENT, 0, 1); 
lv planet.setFooterDividersEnabled(true); 
lelseif(arg? 一 6){ // 显示 项 部 分 隔 线 ( 别 睹 折腾 了 ， 显 示 不 了 ) 
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params = new LinearLayout.LayoutParams(LayoutParams. MATCH PARENT, 0, 1); 
lv planet.setFooterDividersEnabled(true); 
lv planet.setHeaderDividersEnabled(true); 

lelseif(arg? 一 7){ / 显示 全 部 分 隔 线 (看 我 用 padding 大 法 ) 
lv planet.setPadding(0, dividerHeight, 0, dividerHeight); 
lv planet.setBackgroundDrawable(drawable); 

; 

lv planet.setLayoutParams(params); 

$ 


public void onNothingSelected(AdapterView<?> arg0) { 
; 
i 


根据 分 隔 线 测试 代码 的 演示 结果 ， 笔 者 总 结 了 一 下 ， 大 概 有 以 下 S 种 情况 : 


(1) 代码 中 的 setDivider 方法 只 能 设置 具体 的 图 片 ， 不 能 设置 颜色 ， 即 使 把 颜色 值 转 为 
ColorDrawable 也 不 行 。 在 布局 文件 中 可 对 divider 属性 直接 指定 颜色 值 。 

(2) divider 属性 设置 为 @null 时 不 能 再 设置 dividerHeight 属性 为 大 于 0 的 数值 ， 因 为 这 
样 一 来 最 后 一 项 就 不 会 完全 显示 ， 底 部 有 一 部 分 被 掩盖 了 。 原 因 是 列表 高 度 为 wrap_content 
时 ,系统 已 按照 没有 分 隔 线 的 情况 计算 列表 高 度 , 此 时 dividerHeight 占用 了 n-1 块 空白 分 隔 区 
域 ， 最 后 一 项 被 挤 到 背影 里 面 去 了 ， 有 具体 效果 如 图 5-5 所 示 。 

(3) 代码 中 要 设置 分 隔 线 ， 务 必 先 调用 setDivider 方法 再 调用 setDividerHeight 方法 。 如 
果 先 调用 setDividerHeight 再 调用 setDivider， 分 隔 线 高 度 就 会 变 成 分 隔 图 片 的 高 度 ， 而 不 是 
setDividerHeight 设置 的 高 度 ， 有 具体 效果 如 图 5-6 所 示 。 布 局 文件 不 存在 先后 顺序 问题 。 









m “只 显示 内 部 分 隔 线 ( 先 设置 分 隔 线 高 度 ) ~ 


水 星 
二 小 的 一 里 行 


星 ,也 是 离 太阳 最 近 的 


金星 


金星 是 太阳 系 八大 行星 之 一 ， 排 行 第 二 ， 距 离 太 
阳 0.725 天 文 单位 


分 隔 线 显示 不 显示 分 隔 线 (分 隔 线 为 null) 


水 星 

E 水 星 是 太阳 系 八大 行星 最 内 便 也 是 最 小 的 一 甘 行 
星 , 也 是 离 太阳 最 近 的 行星 
金星 
金星 是 大 阳 系 八大 行星 之 一 ， 排 行 第 二 ， 距离 太 
阳 0.725 天 文 单位 












P 地 球 地 球 
f 地 球 是 太阳 系 八 大 行星 之 一 ， 排 行 第 三 ， 也 是 太阳 系 
地 球 是 太阳 系 八大 行星 之 一 ， 排 行 第 三 ， 也 是 太阳 系 i 
sse. RERSSRADAIEGR , NAILS ee 





火星 


~ ,排行 第 四 ， 属 于 类 地 行 
星 ,直径 约 为 地 球 的 53: 


火星 


火星 是 太阳 系 八大 行星 之 一 ， 排 行 第 四 ， 帮 于 类 地 行 
星 ,直径 约 为 地 球 的 53% 


木星 
W t-r 2 自转 最 快 的 行 
第 五 。 它 的 质量 为 太阳 的 千 分 之 一 ， 但 为 太 
TRAC CACRRRZ R2 5 倍 
E 












AE 
TERAMENANECAREA. BIBIT 
行 第 五 ， 它 的 质量 为 大 了 的 分 之 一 ,但 为 太 
它 七 大 ; 






E 
土星 为 太阳 系 八大 行星 之 一 ， 排 行 第 六 ,体积 仅 次 于 
*= 


土星 


土星 为 太阳 系 八大 行星 之 一 ， 排 行 第 六 ， 体 积 仅 次 于 














图 5-5 divider 属性 设置 为 @null 5-6” 先 调用 setDividerHeight 
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(4) 显示 列表 底部 的 分 隔 线 是 有 条 件 的 ， 即 当前 ListView 的 高 度 不 能 为 wrap. content, 
否则 就 算 把 footerDividersEnabled 设置 为 true、 调 用 setFooterDividersEnabled 方法 设置 为 true， 
这 条 底部 的 分 隔 线 也 不 会 出 现 。 除非 把 列表 的 高 度 设置 为 match parent 或 设置 足够 高 , 才 会 显 
示 底 部 的 分 隔 线 ， 调 整 列表 高 度 后 的 具体 效果 如 图 5-7 所 示 。 

(5) 列表 顶部 的 分 隔 线 就 更 难 办 了 ，ListView 不 会 显示 顶部 的 分 隔 线 。 无 论 是 
headerDividersEnabled 属性 还 是 setHeaderDividersEnabled 方法 都 没有 作用 , 而 且 调 整 列表 高 度 
也 没什么 用 ， 非 常 难以 解决 。 





m “显示 底部 分 隔 线 (高 度 是 match_parent) ~ 分 隔 线 显 示 ”显示 全 部 分 隔 线 (看 我 用 padding 大 法 ) "~ 


水 星 

P ae ae aaa 最 行 
旺 ,也 是 离 太阳 最 近 的 行 

金星 

A 排行 第 二 ,距离 太 
阳 0.725 天 文 单 


地 球 
地 球 是 太阳 系 八大 行星 之 一 ， 排行 第 三 ， 也 是 太阳 系 
中 直径 、 质 量 和 密 硫 最 大 的 基地 行星 ， IRA SC 


火星 


水 星 

水 星 是 太阳系 八大 行星 最 内 侧 也 是 最 小 的 一 各 和 
星 , 也 是 离 太 阳 最 近 的 行星 

金星 

RRRAREAAGE2- WIM, EN 
阳 0.725 天 文 单位 

地 球 

地 球 是 太阳系 八大 行星 之 一 ， 排 行 第 三 ， 也 是 大 阳 系 
中 直径 、 质 量 和 密度 最 大 的 类 地 行星 ， 距离 太阳 1.5 亿 


火星 


K AD AUNT: 排行 第 四 ， 属 于 类 地 行 火星 是 太阳 系 八大 行星 之 一 ， 排 行 第 四 ,属于 类 地 行 
星 ,直径 约 为 地 球 的 53 星 ,直径 约 为 地 球 的 53% 


木星 
木星 是 太阳 系 八大 行星 中 体积 最 大 、 自 转 最 快 的 行 
P sas. 生生 人 全 二 > 但 为 太 


+m 
/NA ， 排行 第 六 ， 体积 仅 次 于 


行星 中 体积 最 大 、 自 转 最 快 的 行 
它 为 太 | ^ dna 但 为 太 





土星 为 太阳 系 八 大 行星 之 一 ， 排 行 第 六 ， 体积 仅 次 于 
木星 





5-7 ”高 度 设置 为 match parent 图 5-8 padding 显示 头 尾 分 隔 线 


既然 底部 和 项 部 的 分 隔 线 令 人 这 般 头 痛 , 不 如 直接 扔 掉 , 另外 想 想 别 的 办 法 。 使 用 padding 
即 可 解决 这 个 问题 。 首 先 给 ListView 设置 背景 图 片 ， 然 后 分 别 设置 paddingTop 与 
paddingBottom， 接 下 来 项 部 和 底部 就 会 出 现 两 个 背景 图 的 padding， 具 体 效 果 如 图 5-8 所 示 。 

上 面 第 3 点 和 第 5 点 已 经 明确 是 Android 的 bug， 较 真 的 读者 不 必 把 时 间 浪 费 在 上 面 。 这 
不 是 设置 问题 ， 也 不 是 方法 调用 问题 ， 而 且 SDK 的 代码 逻辑 问题 ， 详 述 如 下 : 


CD 关于 setDivider 方法 与 setDividerHeight 方法 的 先后 顺序 关系 , 参见 下 面 的 setDivider 
方法 源码 , 问题 在 于 if 条 件 , XE “divider != null” 的 条 件 不 准确 , 应 当 改 为 “dividerl=null && 
mpDividerHeight<=0”， 如 果 已 经 指定 分 隔 线 的 高 度 ， 就 不 用 使 用 分 隔 图 片 的 高 度 了 。 


public void setDivider(@Nullable Drawable divider) í 
if (divider != null) í 
mDividerHeight = divider.getlntrinsicHeight(); 
) else ( 
mDividerHeight = 0; 
D 
mbDivider = divider; 
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mDividerlsOpaque = divider = null || divider.getOpacity() = PixelFormat.OPAQUE; 
requestLayout(); 
invalidate(); 
ji 
(2) 关于 无 法 显示 项 部 的 分 隔 线 问题 ， 可 查看 ListView 源码 的 dispatchDraw 方法 ， 这 里 
把 问题 代码 贴 出 来 了 ， 有 具体 如 下 : 
bounds.top = bottom; 
bounds.bottom = bottom + dividerHeight; 
drawDivider(canvas, bounds, i); 





n 


可 以 看 到 分 隔 线 固 定 在 该 项 底部 , 如 果 在 项 部 看 到 购物 车 w 
DR, 那 才 是 怪事 。 正确 的 写法 是 对 项 部 的 分 隔 线 做 ER tm — mm e 总 从 | 


分 支 处 理 ， 如 果 需 要 展示 项 部 的 分 隔 线 ， 就 给 
bounds.bottom 赋值 为 child.getTop()， 给 bounds.top 赋 
值 为 child.getTop()-dividerHeight。 
幸好 ListView 的 这 些 毛病 都 是 小 问题 ， 不 影响 将 
其 发 扬 光 大 。 上 一 章 的 实战 项 目 一 一 购物 车 中 有 商品 列 
表 展 示 , 当时 采取 的 是 多 个 LinearLayout 依次 从 上 往 下 
排列 在 每 行 线性 布局 中 再 放 入 商品 图 片 、 名 称 、 价 格 
等 信息 , 该 做 法 在 代码 中 动态 添加 每 个 控件 , 费时 费力 
而 且 容 易 出 错 。 这 种 情况 用 ListView 通过 适配器 显示 
商品 列表 更 合理 ， 有 具体 的 代码 实现 过 程 与 BaseAdapter 
方式 类 似 ， 完 成 后 的 购物 车 页 面 效果 如 图 5-9 所 示 。 
在 实战 中 ，ListView 表现 得 还 不 是 很 完美 ， 有 3 
个 地 方 要 特别 注意 : 图 5-9 使 用 列表 视图 改造 后 的 购物 车 页 面 
A) 如 果 ListView 下 面 还 有 其 他 控件 ， 就 要 将 ListView 的 高 度 设 为 0dp， 权 重 设 为 1, 
确保 列表 视图 扩展 到 所 有 剩余 页 面 ; WR ListView 的 高 度 设置 为 wrap_content， 系 统 就 只 预 留 
- 行 高 度 ， 如 此 一 来 只 有 第 一 行 显示 ， 这 显然 不 是 我 们 所 期 望 的 。 在 图 5-9 中 ， 我 们 看 到 结算 
行 位 于 页 面 底 部 ， 就 是 因为 列表 视图 占据 了 页 面 的 剩余 空间 ， 导 致 结算 行 被 挤 到 最 下 面 了 。 
(2) 给 列表 项 注册 上 下 文 菜单 也 不 容易 ， 如 果 按 照 之 前 对 上 下 文 菜单 的 操作 ， 长 按 列 表 
项 时 App 就 会 异常 退出 。 这 是 因为 上 下 文 菜单 的 长 按 事件 与 列表 项 的 长 按 监听 器 
OnltemLongClickListener 相互 影响 , 使 得 程序 陷入 了 死 循 环 。 最 后 的 处 理 办 法 是 要 把 两 种 长 按 
事件 阻隔 开 , 即 列表 项 长 按 事 件 处 理 完毕 后 才 触 发 上 下 文 菜单 事件 , 打开 上 下 文 菜单 之 前 得 清 
空 列表 项 的 长 按 事 件 ， 具 体 代 码 如 下 : 
private View mCurrentView; 
(QOverride 
public boolean onItemLongClick(AdapterView-?- parent, View view, int position, long id) í 
mCurrentGood — mCartArray.get(position); 
mCurrentView — view; 


"aiiis 
ua | 24992499 
- 3G8+32GBI8 Vaf 
通 4G 手 机 (AXR) 
E OPPO R9plus 
OPPO R9plus 1 24992499 
4GB-64GB 内 行 版 全 他 
LIGEN BERIS 


小 米 5 

1 17991799 
小 米 于 机 5 hit NA 
TS IGBATI 64G8 If. 





mim: 6797 结算 














Android Studio TF 325: 从 零 基础 到 App 上 线 





mHandler.postDelayed(mPopupMenu, 100); 
return true; 


j 


private Handler mHandler = new Handler(); 
private Runnable mPopupMenu = new Runnable() í 
@Override 
public void run() { 
lv_cart.setOnItemLongClickListener(null); 
registerForContextMenu(mCurrent View); 
openContextMenu(mCurrentView); 
unregisterForContextMenu(mCurrent View); 
lv cart.setOnItemLongClickListener(ShoppingCartActivity.this); 
ji 
h 
G) 如 果 列 表 项 包含 EditText、Button (包括 ImageButton, CheckBox 等 按钮 ) 等 控件 ， 
此 时 点 击 列表 项 不 会 啊 应 点 击 监听 器 OnItemClickListener。 罪 魁 祸首 还 是 焦点 抢占 问题 ， 之 前 
介绍 EditText 时 提 到 页 面 会 自动 弹出 软 键盘 ,就 是 EditText 抢占 焦点 造成 的 。 同 理 ， 列 表 项 中 
如 果 存 在 EditText 和 Button， 这 些 子 控件 也 会 抢占 列表 项 的 焦点 ， 使 得 点 击 操作 被 视 为 对 
EditText 和 Button 的 点 击 〈 无 论点 击 处 是 否 落 在 EditText 和 Button 的 范围 内 ) ， 而 不 是 列表 
项 的 点 击 。 解 决 办 法 是 给 列表 项 布局 文件 的 根 节点 加 上 descendantFocusability 属性 ， 并 声明 在 
列表 项 范围 内 和 剥夺 子 控件 的 抢占 权利 ， 有 具体 的 属性 设置 代码 如 下 : 


android:descendantFocusability="blocksDescendants" 


5.2.8 ”网 格 视图 GridView 





除了 列表 视图 , 网 格 视图 GridView 也 是 常见 的 适配器 视图 , 用 于 分 行 分 列 显示 表格 信息 ， 
比 ListView 更 适合 展示 商品 清单 。GridView 新 增 的 属性 与 方法 说 明 见 表 5-2。 


表 5-2 GriView 的 属性 与 方法 说 明 

















XML 中 的 属性 GridView 类 的 设置 方法 | 说 明 

horizontalSpacing setHorizontalSpacing 指定 网 格 项 在 水 平方 向 的 间距 

verticalSpacing setVerticalSpacing 指定 网 格 项 在 垂直 方向 的 间距 

numColumns setNumColumns 指定 列 的 数目 

stretchMode setStretchMode 指定 剩余 空间 的 拉 伸 模 式 。 拉 伸 模 式 的 取 值 说 明 见 表 5-3 
columnWidth setColumnWidth 指定 每 列 的 宽度 。 拉 伸 模式 为 spacingWidth、 





spacingWidthUniform 时 ， 必 须 指 定 列 宽 





表 5-3 拉 伸 模式 的 取 值 说 明 






XML 中 的 拉 伸 模式 
none 


columnWidth 


GridView 类 的 拉 伸 模 式 
NO STRETCH 
STRETCH COLUMN WIDTH 


说 明 
不 拉 伸 
车 有 剩余 空间 ， 则 拉 伸 列 宽 挤 掉 空 阶 
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( 续 表 ) 
















XML 中 的 拉 伸 模式 | GridView 类 的 拉 伸 模式 说 明 

spacingWidth STRETCH SPACING 若 有 剩余 空间 ， 则 列 宽 不 变 ， 把 空间 分 配 到 每 列 
间 的 空隙 

spacingWidthUniform | STRETCH SPACING UNIFORM | 若 有 剩余 空间 ， 则 列 宽 不 变 ， 把 空间 分 配 到 每 列 






左右 的 空隙 





另外 ，GridView 实现 了 3 个 与 适配器 相关 的 方法 。 


e setAdapter: 设置 网 格 项 的 数据 适配器 ， 适 配器 一 般 继承 BaseAdapter。 
e setOnltemClickListener: 设置 网 格 项 的 点 击 事件 监听 器 ， 用 法 同 ListView. 
e setOnltemLongClickListener: 设置 网 格 项 的 长 按 事件 监听 器 ， 用 法 同 ListView. 


可 以 看 到 ， 网 格 视图 不 像 列 表 视 图 那样 有 指定 分 隔 线 的 方法 ， 但 这 并 不 意味 着 GridView 
就 没 法 设置 分 隔 线 。 通 过 变通 的 方式 也 能 给 GridView 设置 分 隔 线 。 具 体 地 说 ， 就 是 先 给 
GridView 设置 背景 色 (例如 黑色 ) ， 以 及 网 格 之 间 的 水 平 间距 和 策 直 间距 ， 然 后 给 网 格 项 设 
置 背 景色 (例如 白色 ) ， 这 样 只 有 网 格 间距 是 黑色 ， 从 而 间接 设置 了 黑色 的 分 阳线 。 

下 面 是 演示 网 格 视 图 分 阳线 的 测试 代码 片段 : 


private class DividerSelectedListener implements OnltemSelectedListener í 
public void onltemSelected( AdapterView<?> arg0, View argl, int arg2, long arg3) { 
gv. planet.setBackgroundColor(Color.RED); 
gv. planet.setHorizontalSpacing(dividerPad); 
gv. planet.setVerticalSpacing(dividerPad); 
gv planet.setStretchMode(GridView.STRETCH COLUMN WIDTH); 
gv. planet.setColumnWidth(250); 
gv. planet.setPadding(0, 0, 0, 0); 
if(arg? — 0) { / 不 显示 分 隔 线 
gv. planet.setBackgroundColor(Color. WHITE); 
gv. planet.setHorizontalSpacing(0); 
gv. planet.setVerticalSpacing(0); 
}elseif(arg2 一 1){ // 只 显示 内 部 分 隔 线 (NO_STRETCH) 
gv. planet.setStretchMode(GridViewNO STRETCH); 
} else if (arg2 一 2){ // 只 显示 内 部 分 隔 线 (COLUMN_WIDTH) 
gv. planet.setStretchMode(GridView.STRETCH COLUMN WIDTH); 
} else if (arg? 一 3){ // 只 显示 内 部 分 隔 线 (STRETCH SPACING) 
gv_planet.setStretchMode(GridView.STRETCH_SPACING); 
} else if (arg2 一 4){ // 只 显示 内 部 分 隔 线 (SPACING_UNIFORMD) 
gv_planetsetStretchMode(GridView.STRETCH SPACING UNIFORM); 
lelseif(arg? 一 5){ // 显示 全 部 分 隔 线 〈 使 用 padding) 
gv planet.setPadding(dividerPad, dividerPad, dividerPad, dividerPad); 
} 
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public void onNothingSelected(AdapterView<?> arg0) í 
; 
} 


接 下 来 观察 分 隔 线 的 测试 效果 ， 如 图 5-10 所 示 。 默 认 情况 下 ， 网 格 视图 没有 分 隔 线 ; 但 
通过 给 整个 视图 与 网 格 项 分 别 设置 背景 色 可 间接 实现 分 隔 线 ， 如 图 5-11 所 示 。 

图 5-11 所 示 的 分 隔 线 是 在 拉 伸 模式 为 columnWidth 时 的 效果 , 这 也 是 最 常用 的 拉 伸 模式 。 
如 果 拉 伸 模 式 为 其 他 值 ， 间 距 效果 就 大 不 一 样 。 图 5-12 所 示 是 拉 伸 模 式 为 none 时 的 界面 ， 每 
行 右边 都 多 出 了 空 阶 。 拉 伸 模式 为 spacingWidth 时 ， 空 阶 均匀 分 配给 每 列 之 间 的 间距 ， 即 变 
相 拉 大 了 horizontalSpacing， 有 具体 效果 如 图 5-13 所 示 。 
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图 5-10 没有 分 隔 线 效果 图 5-11. 拉 伸 模式 为 columnWidth 
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图 5-12 拉 伸 模式 为 none 图 5-13 拉 伸 模式 为 spacingWidth 
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拉 伸 模式 为 spacingWidthUniform 时 ， 分 配给 每 列 的 空隙 被 分 成 两 半 ， 一 半 加 到 网 格 项 的 

边 ， 一 半 加 到 网 格 项 的 右边 ， 具 体 效果 如 图 5-14 所 示 。 这 样 看 来 ， 还 是 columnWidth 的 拉 

伸 最 符合 实际 ， 因 为 不 浪费 空间 。 然 而 GridView 的 间距 设置 跟 ListView 有 同样 的 毛病 ,无 论 

是 horizontalSpacing 还 是 verticalSpacing， 都 设置 不 了 整个 网 格 视图 的 边缘 ， 也 就 是 对 四 周 的 

分 隔 线 依然 无 能 为 力 。 这 时 还 是 得 使 出 padding， 使 用 padding 能 对 付 不 同 的 对 象 ， 这 才能 体 
现 其 精妙 所 在 。 图 5-15 所 示 为 运用 padding 后 的 效果 图 。 
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5-14 ” 拉 伸 模式 为 spacingWidthUniform 
接 下 来 我 们 继续 在 实战 中 运用 GridView， 因 为 











实践 出 真知 。 上 一 节 的 列表 视图 已 经 成 功 改 造 了 购物 
车 的 商品 列表 ， 现 在 用 网 格 视图 改造 商品 频道 页 面 ， 
六 部 手机 正好 做 成 三 行 两 列 的 GridView。 采 用 网 格 d 
视图 改造 的 商品 频道 页 面 效 果 如 图 5-16 所 示 。 ou 
对 该 页 面 进行 功能 测试 时 ， 可 能 会 发 现 以 下 NS eis 
问题 : B A 
(1) 网 格 项 内 有 一 个 “加 入 购物 车 ”按钮 ， 使 1 
得 网 格 项 的 点 击 事 件 失效 (原本 点 击 网 格 项 跳 转 到 商 e d = "a 
品 详情 页 面 ) 。 这 个 问题 好 办 ， 前 面 介绍 ListView š. m 
时 已 经 提 到 了 ， 原 因 是 网 格 项 的 焦点 被 按钮 抢占 了 ， Eo m ` 
解决 办 法 是 在 网 格 项 布局 的 根 节点 加 上 下 面 这 行 : sl 
2499 加 入 购物 车 2199 加 入 购物 车 





android:descendantFocusability="blocksDescendants" 

OD 点 击 “ 加 入 购物 车 ”按钮 ， 除 了 修改 数据 

库 外 ， 还 得 刷新 页 面 右 上 方 购物 车 图 标 上 的 数字 ， 相 当 于 适配器 把 消息 传 回 给 Activity。 对 于 
这 个 问题 ， 可 借鉴 点 击 监听 器 的 做 法 ， 有 具体 步骤 如 下 : 


图 5-16 使 用 网 格 视图 改造 后 的 商品 频道 页 面 
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ED) 定义 一 个 监听 器 接口 addCartListener， 在 适配器 的 构造 函数 中 传 入 该 监听 器 的 对 象 ， 示 
例 代码 如 下 : 

public GoodsAdapter(Context context, ArrayList<GoodsInfo> goods list, addCartListener listener) í 
mlnflater = LayoutlInflater.from(context); 
mContext = context; 
mGoodsArray = goods list; 
mA ddCartListener = listener; 

5 


private addCartListener mAddCartListener; 
public static interface addCartListener í 
public void addToCart(long goods id); 
} 
EO 使 用 适配器 处 理 “ 加 入 购物 车 ”按钮 的 点 击 操作 时 ， 调 用 监听 器 的 内 部 方法 addToCart, 
示例 代码 如 下 : 


mAddCartListener.addToCart(info.rowid); 


€KD3 Activity 的 页 面 代码 要 实现 addCartListener 接口 的 addToCart 方法 ， 进 行 对 应 的 购物 车 
业务 逻辑 处 理 ， 同 时 记 住 往 适配器 的 构造 函数 传 入 该 监听 器 的 对 象 。 



































5.3” 翻 页 类 视图 


本 节 介 绍 如 何在 页 面 上 运用 翻 页 类 视图 ， 包 括 翻 页 视图 ViewPager 配合 翻 页 适配器 
PagerAdapter 的 用 法 、 翻 页 标题 栏 PagerTitleStrip/PagerTabStrip 的 用 法 ， 最 后 结合 实战 演示 使 
用 ViewPager 实现 简单 的 启动 引导 页 效果 。 


5.3.1 翻 页 视图 ViewPager 


上 一 节 介 绍 的 ListView 与 GridView， 一 个 分 行 展示 ， 另 一 个 分 行 又 分 列 ， 其 实 都 是 在 垂 
直方 向 上 下 滑动 。 有 没有 一 种 控件 允许 页 面 在 水 平方 向 左右 滑动 ， 就 像 翻 书 、 翻 报纸 一 样 呢 ? 
对 于 这 种 左右 滑动 的 翻 页 功能 ，Android 提供 了 已 经 封装 好 的 控件 ， 就 是 翻 页 视图 ViewPager。 
对 于 ViewPager 来 说 ， 一 个 页 面 就 是 一 个 项 (相当 于 ListView 的 一 个 列表 项 ) ， 许 多 页 面 组 
成 ViewPager 的 页 面 项 。 

明确 了 ViewPager 的 原理 类 似 ListView 和 GridView， 翻 页 视图 的 用 法 也 与 之 类 似 。 
ListView 和 GridView 的 适配器 使 用 BaseAdapter，ViewPager 的 适配器 使 用 PagerAdapter; 
ListView 和 GridView 的 监听 器 使 用 OnltemClickListener, ViewPager 的 监听 器 使 用 
OnPageChangeListener， 表 示 监 听 页 面 切换 事件 。 

下 面 是 ViewPager 三 个 常用 方法 的 说 明 。 
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e setAdapter: 设置 页 面 项 的 适配器 。 适 配器 用 的 是 PagerAdapter 及 其 子 类 。 

e setCurrentItem: 设置 当前 页 码 ， 即 打开 翻 页 视图 时 默认 显示 哪个 页 面 。 

e addOnPageChangeListener: 设置 翻 页 视图 的 页 面 切换 监听 器 。 该 监听 器 需 实 现 接口 
OnPageChangeListener 下 的 3 个 方法 ， 具 体 说 明 如 下 。 


» onPageScrollStateChanged: 在 页 面 滑动 状态 变化 时 触发 。 
> onPageScrolled: 在 页 面 滑动 过 程 中 触发 。 
> onPageSelected: 在 选中 页 面 时 ， 即 滑动 结束 后 触发 。 


翻 页 适配器 PagerAdapter 与 基本 适配器 BaseAdapter 的 用 法 相近 ， 需 实现 构造 函数 、 获 取 
页 面 个 数 的 getCount 方法 、 生 成 单个 页 面 视图 的 instantiateltem 方法 ， 另 外 多 了 一 个 回收 页 面 
的 destroyItem 方法 。 下 面 是 使 用 PagerAdapter 的 代码 : 


public class ImagePagerAdapater extends PagerAdapter í 
private Context mContext; 
private ArrayList<ImageView> m ViewList = new ArrayList<ImageView>(); 
private ArrayList<GoodsInfo> mGoodsList = new ArrayList<GoodsInfo>(); 


public ImagePagerAdapater(Context context, ArrayList<GoodsInfo> goodsList) { 

mContext = context; 

mGoodsList = goodsList; 

for (int i=0; i<mGoodsList.size(); i++) í 
ImageView view = new ImageView(mContext); 
view.setLayoutParams(new LayoutParams( 

LayoutParams.MATCH PARENT, LayoutParams. WRAP CONTENT)); 

view.setlImageResource(mGoodsL ist.get(i).pic); 
view.setScaleType(ScaleType.FIT CENTER); 
mViewList.add(view); 


(@Override 
public int getCount() í 
return mViewList.size(); 


@Override 
public boolean isViewFromObject(View arg0, Object arg1) í 
return arg0 — argl; 


@Override 
public void destroyItem(ViewGroup container, int position, Object object) í 
container.removeView(mViewList.get(position)); 
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@Override 

public Object instantiateltem(ViewGroup container, int position) í 
container.addView(m ViewList.get(position)); 
return mViewList.get(position); 


$ 
与 适配器 ImagePagerAdapater 对 应 的 页 面 代码 如 下 : 


public class ViewPagerActivity extends AppCompatActivity implements OnPageChangeL istener { 
private ArrayList«GoodsInfo» goodsList; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity view pager); 
ViewPager vp content = (ViewPager) find ViewByld(R.id.vp content); 
goodsList = GoodsInfo.getDefaultList(); 
ImagePagerA dapater adapter = new ImagePagerA dapater(this, goodsList); 
vp. content.setAdapter(adapter); 
vp. content.setCurrentItem(0); 
vp. content.addOnPageChangeListener(this); 

j 


// 翻 页 状态 改变 时 调用 ， 状 态 参数 取 值 说 明 为 : 0 表示 静止 ，!1 表示 正在 滑动 ，2 表示 滑动 完毕 
/在 翻 页 过 程 中 ， 状 态 值 变化 依次 为 : 正在 滑动 一 滑动 完毕 一 静止 

@Override 

public void onPageScrollStateChanged(int arg0) í 

; 


/在 翻 页 过 程 中 调用 。 该 方法 的 三 个 参数 取 值 说 明 为 : 第 一 个 参数 表示 当前 页 面 的 序号 

// 第 二 个 参数 表示 当前 页 面 偏 移 的 百分比 ， 取 值 为 0 到 1; 第 三 个 参数 表示 当前 页 面 的 偏 移 距 离 
(@Override 

public void onPageScrolled(int arg0, float argl, int arg2) í 

; 


(a Override 
public void onPageSelected(int arg0) í 
Toast.makeText(this, "您 翻 到 的 手机 品牌 是 : "+goodsList.get(arg0).name, 
Toast.LENGTH SHORT).show(); 
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下 面 是 页 面 代 码 对 应 的 布局 文件 代码 ,注意 ViewPager 的 节点 名 必须 引用 v4 包 的 全 路 径 ， 
即 android.support.v4.view.ViewPager。 


<LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height-"match parent" 
android:orientation-" vertical" 
android:padding-" 10dp" > 
«android.support.v4.view. ViewPager 
android:id—"(a)*id/vp content" 
android:layout width-"match parent" 
android:layout height-"400dp" /> 
*/LinearLayout^ 


具体 的 翻 页 效果 如 图 5-17 所 示 。 截 图 的 瞬间 ，ViewPager 正在 左右 两 个 页 面 之 间 滑 动 。 


Senior 





图 5-17 ” 翻 页 视图 滚动 瞬间 
5.3.2” 翻 页 标题 栏 PagerTitleStrip/PagerTabStrip 


为 了 方便 开发 者 处 理 ViewPager 的 页 码 显示 与 切换 ，Android 附带 提供 了 两 个 控件 ， 分 别 
是 PagerTitleStrip 和 PagerTabStrip。 二 者 都 是 在 ViewPager 页 面 上 方 展示 设 定 的 页 面 标题 ， 不 
同 之 处 在 于 PagerTitleStrip 只 是 单纯 的 文本 标题 效果 ， 无 法 点 击 进行 页 面 切换 ，PagerTabStrip 
类 似 选 项 卡 效 果 , 文本 下 面 有 横 线 ， 点 击 左右 选项 卡 即 可 切换 到 对 应 页 面 。 要 想 在 标题 栏 显 示 








指定 的 文字 ， 得 重 写 PagerAdapter 的 getPageTitle 方法 ， 在 这 方面 两 个 控件 的 处 理 是 一 样 的 ， 
示例 代码 如 下 : 


@Override 
public CharSequence getPageTitle(int position) { 
return mGoodsList.get(position).name; 
5 
下 面 是 在 布局 文件 中 添加 PagerTitleStrip 的 代码 ， 注 意 PagerTitleStrip 的 节点 名 必须 引用 
v4 包 的 全 路 径 ， 即 android.support.v4.view.PagerTitleStrip。 如果 用 PagerTabStrip ， 就 把 








Android Studio FERK: MEEME] App 上 线 





PagerTitleStrip 改 为 PagerTabStrip。 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height-"match parent" 
android:orientation-"vertical" 
android:padding-" 10dp" > 


«android.support.v4.view. ViewPager 
android:id-"(g)*id/vp content" 
android:layout width-"match parent" 
android:layout height-"400dp" > 


«android.support.v4.view.PagerTitleStrip 
android:id-"(g*id/pts title" 
android:layout width-"wrap content" 
android:layout height-"wrap content" /> 
«/android.support.v4.view. ViewPager» 
*/LinearLayout^ 


翻 页 标题 栏 的 显示 界面 很 简单 ， 正 上 方 是 当前 页 面 的 标题 ， 左 上 方 是 左边 页 面 的 标题 ， 
右上 方 是 右边 页 面 的 标题 。PagerTitleStrip 的 标题 只 有 文字 ， 如 图 5-18 所 示 。PagerTabStrip 除 
了 文字 还 有 下 划 线 ， 如 图 5-19 所 示 。 
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图 5-18  PagerTitleStrip 的 效果 图 5-19 PagerTabStrip 的 效果 
标题 栏 因 为 只 有 文本 ， 所 以 调整 样式 只 能 改 改 文字 的 大 小 与 颜色 。 注 意 这 两 个 控件 没 法 
在 布局 文件 中 修改 文字 样式 , 因为 没有 对 应 的 样式 属性 , 只 能 在 代码 中 调用 文本 样式 的 设置 方 
法 ， 具 体 的 代码 如 下 : 
PagerTabStrip pts tab = (PagerTabStrip) findViewById(R.id.pts tab); 


pts tab.setTextSize(TypedValue. COMPLEX UNIT SP, 20); 
pts tab.setTextColor(Color. GREEN); 
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5.3.3 简单 的 启动 引导 页 


ViewPager 的 应 用 很 广 ， 当 我 们 安装 一 个 新 的 App 时 ， 第 一 次 启动 大 多 出 现 欢 迎 页 面 ， 这 
个 引导 页 通常 要 往 右 翻 好 几 页 ， 才 会 进入 App 的 主页 面 。 启 动 引导 页 的 效果 大 多 是 ViewPager 
做 的 。 

下 面 就 来 动手 打造 你 的 第 一 个 App 启动 欢迎 页 吧 !ViewPager 技术 的 核心 在 于 页 面 项 的 布 
局 及 其 适配器 ,因此 首先 要 设计 页 面 项 的 布局 。 一 般 来 说 ， 引 导 页 主要 由 两 部 分 组 成 ， 一 部 分 
是 背景 图 ; 另 一 部 分 是 页 面 下 方 的 一 排 圆 点 ， 高 亮 的 圆 点 表示 当前 位 于 第 几 页 。 具 体 效 果 如 图 
5-20 与 图 5-21 所 示 。 其 中 ， 图 5-20 所 示 为 欢迎 页 面 的 第 一 页 ， 图 5-21 所 示 为 第 二 页 ， 高 亮 
圆 点 移 到 第 二 个 。 


[ELE e 





图 5-20 ”欢迎 页 的 第 一 页 图 5-21 欢迎 页 的 第 二 页 


除了 背景 图 与 一 排 圆 点 ， 最 后 一 页 往往 有 一 个 按钮 ， 是 进入 主页 面 的 入 口 。 页 面 项 的 布 
局 文件 至 少 有 3 个 控件 : 背景 图 (采用 ImageView) 、 一 排 圆 点 (可 采用 RadioGroup) 、 入 
口 按钮 〈 采 用 Button) ， 详 细 的 代码 如 下 : 


<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" > 


<ImageView 
android:id="(@+id/iv_launch" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:scaleType-"fitXY" > 
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<RadioGroup 
android:id="(@+id/rg_indicate" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
android:layout alignParentBottom-"true" 
android:layout centerHorizontal-"true" 
android:layout gravity-"bottom|center" 
android:orientation-"horizontal" 
android:paddingBottom-"20dp" /> 


«Button 

android:id-" (à)*id/btn start" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:layout marginLeft-"80dp" 
android:layout marginRight-"80dp" 
android:layout centerInParent-"true" 
android:gravity-"center" 
android:tex 人 "立即 开始 美好 生活 " 
android:textColor="#ff3300" 
android:textSize="22sp" 
android:visibility="gone" />" 

</RelativeLayout> 


根据 该 布局 文件 ， 引 导 页 的 最 后 两 个 页 面 如 图 5-22 与 图 5-23 所 示 。 其 中 , 图 5-22 是 第 3 
个 页 面 ， 高 亮 圆 点 移 到 第 3 个 ;图 5-23 是 最 后 一 个 页 面 ， 只 有 该 页 才 会 显示 入 口 按钮 。 


EZ 





图 5-22 ”欢迎 页 的 第 三 页 图 5-23 ”欢迎 页 的 最 后 一 页 





高 级 控件 # 5 E 





启动 引导 页 的 适配器 代码 主要 工作 是 根据 布局 文件 构造 每 页 的 视图 ， 然 后 把 当前 页 码 的 
点 设置 高 亮 ， 如 果 是 最 后 一 页 就 显示 入 口 按钮 ， 具 体 代 码 如 下 


public class LaunchSimpleAdapter extends PagerAdapter í 
private LayoutInflater mlnflater; 
private Context mContext; 
private ArrayList<View> mViewList = new ArrayList<View>(); 














= 





public LaunchSimpleA dapter( Context context, int[] imageArray) { 
minflater = LayoutInflater.from(context); 
mContext = context; 
for (int i-0; icimageArray.length; i++) í 
View view = mInflater.inflate(R.layout.item launch, null); 
ImageView iv launch = (ImageView) view.find ViewById(R.id.iv launch); 
RadioGroup rg indicate = (RadioGroup) view.find ViewById(R.id.rg indicate); 
Button btn start = (Button) view.findViewById(R.id.btn start); 
iv launch.setImageResource(imageAray[i]); 
for (int j=0; jcimageArray.length; j+) í 
RadioButton radio = new RadioButton(mContext); 
radio.setLayoutParams(new LayoutParams(LayoutParams. WRAP CONTENT, 
LayoutParams. WRAP. CONTENT)); 
radio.setButtonDrawable(R.drawable.launch guide); 
radio.setPadding(10, 10, 10, 10); 
rg indicate.addView(radio); 
j 
((RadioButton)rg_indicate.getChildAt(i)).setChecked(true); 
if (i == imageArray.length-1) í 
btn start.setVisibility( View. VISIBLE); 
btn start.setOnClickListener(new OnClickListener() í 
@Override 
public void onClick(View v) { 
Toast.makeText(mContext, "欢迎 您 开启 美好 生活 "， 
ToastLENGTH SHORT ).show(); 
j 
»x 
j 


mViewList.add(view); 


(QOverride 
public int getCount() í 
return mViewList.size(); 
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j 


@Override 

public boolean isViewFromObject(View arg0, Object arg1) í 
return arg0 = argl; 

5 


(@Override 
public void destroyltem(ViewGroup container, int position, Object object) í 
container.remove View(mViewList.get(position)); 


1 


(@Override 

public Object instantiateltem(ViewGroup container, int position) { 
container.addView(mViewList.get(position)); 
return mViewList.get(position); 


5.4 碎片 Fragment 


本 节 介 绍 如 何在 页 面 上 加 入 碎片 并 合理 使 用 ， 包 括 通过 静态 注册 方式 使 用 碎片 Fragment, 
通过 动态 注册 方式 配合 碎片 适配器 FragmentStatePagerAdapter 使 用 Fragment. 并 分 别 分 析 两 种 
注册 方式 的 Fragment 生命 周期 ， 最 后 结合 实战 使 用 Fragment 对 启动 引导 页 进行 改进 。 


544 静态 注册 


Fragment 是 个 特别 的 存在 ， 有 点 像 报 纸 上 的 专栏 ， 看 起 来 只 占据 页 面 的 一 小 块 ， 但 是 这 一 
小 块 有 自己 的 生命 周期 ， 可 以 自行 其 事 , 仿佛 独立 王国 ， 并 且 这 一 小 块 的 特性 无 论 在 哪个 页 面 ， 
给 一 个 位 置 就 行 ， 添 加 后 不 影响 宿主 页 面 的 其 他 区 域 ， 去 除 后 也 不 影响 宿主 页 面 的 其 他 区 域 。 

每 个 Fragment 都 有 对 应 的 布局 文件 ， 依 据 其 使 用 方式 可 分 为 静态 注册 与 动态 注册 两 类 。 
静态 注册 是 在 布局 文件 中 直接 放置 fragment 节点 ， 类 似 于 一 个 普通 控件 ， 可 被 多 个 布局 文件 
同时 引用 。 静 态 注册 一 般 用 于 某 个 通用 的 页 面部 件 (如 Logo 条 、 广 告 条 等 ) ， 每 个 活动 页 面 
均 可 直接 引用 该 部 件 。 

下 面 是 Fragment 布局 文件 的 代码 ， 看 起 来 跟 列 表 项 与 网 格 项 的 布局 文件 差不多 。 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 

android:layout width-"match parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" 
android:background-"ébbffbb" > 
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<TextView 
android:id="@+id/tv_adv" 
android:layout_width="0dp" 
android:layout height-"match parent" 
android:layout weight-"1" 
android:gravity-"center" 
android:text-"] fi" 
android:textColor-"4000000" 
android:textSize-"17sp" /> 


*ImageView 

android:id—"(a)*id/iv adv" 
android:layout width-"Odp" 
android:layout height-"wrap content" 
android:layout weight-"5" 
android:src-"(a)drawable/adv" 
android:scaleType-"fitCenter" /> 

*/LinearLayout^ 


下 面 是 与 上 述 布局 对 应 的 Fragment 代码 ， 除 了 继承 自 Fragment 外 ， 其 他 地 方 很 像 活动 页 
面 代码 。 


public class StaticFragment extends Fragment implements OnClickListener í 
protected View mView; 
protected Context mContext; 
private TextView tv adv; 
private ImageView iv adv; 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 
mContext = getActivity(); 
mView = inflater.inflate(R.layout.fragment static, container, false); 
tv adv = (TextView) mView.findViewById(R.id.tv adv); 
iv adv = (ImageView) mView.findViewById(R.id.iv adv); 
tv adv.setOnClickListener(this); 
iv adv.setOnClickListener(this); 


return mView; 


(à Override 
public void onClick(View v) í 
if (v.getld() = R.id.tv adv) í 
Toast.makeText(mContext, "您 点 击 了 广告 文本 ", Toast. LENGTH. LONG ).show(); 
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} else if (v.getld() = R.id.iv adv) í 
Toast.makeText(mContext, "您 点 击 了 广告 图 片 " Toast. LENGTH_LONG).show(); 


若 想 在 页 面 布 局 文件 中 引用 Fragment， 则 可 直接 加 入 一 个 fragment 节点 ， 注 意 fragment 
节点 要 增加 name 属性 指定 该 Fragment 类 的 完整 路 径 。 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-" vertical" 
android:padding-"5dp" > 


«fragment 
android:id-"(a)*id/fragment static" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:name-"com.example.senior.fragment.StaticFragment" /> 


«TextView 

android:layout width-"match parent" 
android:layout height-"match parent" 
android:gravity-"center|top" 
android:text=" 这 里 是 每 个 页 面 的 具体 内 容 " 
android:textColor="#000000" 
android:textSize-"17sp" /> 

</LinearLayout> 


最 后 运行 并 查看 页 面 效果 , 如 图 5-24 所 示 。 此 时 Fragment 界面 给 人 的 感觉 就 像 一 个 视图 ， 
同样 可 以 接收 点 击 事件 。 





广告 用 心服 务 fail , 


这 里 是 每 个 页 面 的 具体 内 容 





图 5-24 静态 注册 的 Fragment 效果 
使 用 静态 注册 需要 注意 以 下 两 点 : 


(1)fragment 节点 必须 指定 id 属 性 ,否则 App 运行 时 会 报错 Must specify unique android:id, 
android:tag, or have a parent with an id for *** , 
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(2) 如 果 页 面 代 码 继承 自 Activity, Fragment 类 就 必须 继承 自 android.app.Fragment, ` 
能 使 用 android.support.v4.app.Fragment， 和 否则 App 运行 会 报错 Trying to instantiate a class *** 
that is not a Fragment 或 报错 java.lang.ClassCastException : *** cannot be cast to 
android.app.Fragment; 如 果 页 面 代码 继承 自 AppCompatActivity 或 FragmentActivity， 那 么 无 论 
是 android.app.Fragment 还 是 android.support.v4.app.Fragment 都 可 以 使 用 。 


另外 ， 介 绍 一 下 Fragment 在 静态 注册 时 的 生命 周期 ， 如 Activity 的 基本 生命 周期 方法 
onCreate. onStart, onResume, onPause. onStop. onDestroy, W¥}r Fragment 都 有 ， 而 且 还 多 
出 了 下 面 5 个 生命 周期 方法 。 


e onAttach: 5 Activity 结合 。 可 在 该 方法 中 实例 化 Activity 的 一 个 回调 对 象 ， 在 Fragment 
中 调用 Activity 的 回调 方法 。 这 样 设计 的 好 处 是 Activity 无 须 调用 set***Listener 方法 设 
置 监听 器 接口 。 

onCreateView: 创建 碎片 视图 。 

onActivityCreated: 在 活动 页 面 创建 完毕 后 调用 。 

onDestroyView: 回收 碎片 视图 。 

onDetach: 与 Activity 分 离 。 


至 于 这 些 周期 方法 的 先后 调用 顺序 ， 观 察 日 志 最 简单 明了 。 下 面 是 打开 页 面 时 的 日 志 信 
息 , 此 时 Fragment 的 onCreate 操作 先 于 Activity, 而 onStart 与 onResume 操作 在 Activity 之 后 。 





12:26:11.506: D/StaticFragment(5809): onAttach 
12:26:11.506: D/StaticFragment(5809): onCreate 
12:26:11.530: D/StaticFragment(5809): onCreate View 
12:26:11.530: D/FragmentStaticActivity(5809): onCreate 
12:26:11.530: D/StaticFragment(5809): onActivityCreated 
12:26:11.530: D/FragmentStaticActivity(5809): onStart 
12:26:11.530: D/StaticFragment(5809): onStart 
12:26:11.530:  D/FragmentStaticActivity(5809): onResume 
12:26:11.530: D/StaticFragment(5809): onResume 


下 面 是 退出 页 面 时 的 日 志 信息 , 此 时 Fragment 的 onPause, onStop. onDestroy 都 在 Activity 
之 前 。 

12:26:36.586: D/StaticFragment(5809): onPause 

12:26:36.586: D/FragmentStaticActivity(5809): onPause 

12:26:36.990: D/StaticFragment(5809): onStop 

12:26:36.990: D/FragmentStaticActivity(5809): onStop 

12:26:36.990: D/StaticFragment(5809): onDestroyView 

12:26:36.990: D/StaticFragment(5809): onDestroy 

12:26:36.990: D/StaticFragment(5809): onDetach 

12:26:36.990: D/FragmentStaticActivity(5809): onDestroy 


总 结 一 下 ， 在 静态 注册 时 ， 除 了 碎片 的 创建 操作 在 页 面 创建 之 前 ， 其 他 操作 都 在 页 面 创 
建 之 后 。 就 像 老 实 本 分 的 下 级 ， 上 级 开 腔 后 才能 说 话 ， 上 级 要 做 总 结 性 发 言 时 赶紧 闭 嘴 。 
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5.4.2 ”动态 注册 /碎片 适配器 FragmentStatePagerAdapter 











Fragment 拥有 两 种 使 用 方式 ， 即 静态 注册 和 动态 注册 。 相 比 静 态 注册 ， 实 际 开发 中 动态 
注册 用 的 更 多 。 静 态 注册 在 布局 文件 中 直接 指定 Fragment， 而 动态 注册 直到 在 代码 中 才 动 态 
添加 Fragment。 动 态 生 成 的 碎片 给 谁 用 、 要 怎么 用 呢 ? 毫 无 疑问 ， 动 态 碎片 就 是 给 翻 页 视图 
用 的 ，ViewPager 和 Fragment 是 一 对 好 搭档 。 

要 说 怎么 在 ViewPager 中 使 用 Fragment, 关键 在 于 适配器 。 上 一 节 演 示 ViewPager 时 用 的 
适配器 是 翻 页 适配器 PagerAdapter。 如 果 结 合 Fragment， 适 配器 就 要 改 用 碎片 适配器 
FragmentStatePagerAdapter。 下 面 是 使 用 FragmentStatePagerAdapter 适配器 的 代码 ， 获 取 页 面 
视图 的 地 方 变 成 了 getltem 方法 。 

public class MobilePagerAdapter extends FragmentStatePagerAdapter í 

private ArrayList<GoodsInfo> mGoodsList = new ArrayList<GoodsInfo>(); 

public MobilePagerAdapter(FragmentManager fm, ArrayList<GoodsInfo> goodsList) í 
super(fm); 
mGoodsList = goodsList; 

1 








public int getCount() í 
return mGoodsList.size(); 
h 


public Fragment getltem(int position) í 
return DynamicFragment.newInstance(position, 
mGoodsList.get(position).pic, mGoodsList.get(position).desc); 
j 


@Override 
public CharSequence getPageTitle(int position) { 
return mGoodsList.get(position).name; 
$ 
ji 


以 上 适配器 在 获得 碎片 对 象 时 不 用 构造 函数 , 却 用 了 newInstance 方法 , 目的 是 给 Fragment 
传递 参数 信息 。 通 过 构造 函数 获得 碎片 对 象 后 还 得 调用 setArguments 方法 才能 把 请 求 数据 塞 
进去 , 然后 在 Fragment 的 onCreateView 函数 中 调用 getArguments 方 获得 请 求 数据 。 下 面 是 动 
态 注册 的 碎片 代码 : 

public class DynamicFragment extends Fragment í 

protected View mView; 
protected Context mContext; 
private int mPosition; 


private int mImageld; 
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private String mDesc; 


public static DynamicFragment newlnstance(int position. int image_id, String desc) í 
DynamicFragment fragment = new DynamicFragment(); 
Bundle bundle = new Bundle(); 
bundle.putInt("position", position); 
bundle.putInt("image id", image id); 
bundle.putString("desc", desc); 


fragment.setArguments(bundle); 
return fragment; 

h: 

@Override 


public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 

mContext — getActivity(); 
if (getArguments() != null) í 

mPosition = getArguments().getInt("position", 0); 

mlmageld = getArguments().getInt("image id", 0); 

mDesc = getArguments().getString(" desc"); 
J 
mView = inflater.inflate(R.layout.fragment dynamic, container, false); 
ImageView iv pic = (ImageView) mView.findViewByld(R.id.iv_pic); 
TextView tv desc = (TextView) mView.findViewByld(R.id.tv desc); 
iv pic.setImageResource(mImageld); 
tv. desc.setText(mDesc); 
return mView; 


; 

现在 有 了 适用 于 动态 注册 的 适配器 与 碎片 对 象 ， 还 需要 一 个 主页 面 配合 才能 完成 整个 页 
面 的 展示 。 下 面 是 动态 注册 用 到 的 页 面 代码 ， 注 意 这 里 不 能 继承 Activity ， 只 能 继承 
AppCompatActivity 或 FragmentActivity 。 





public class FragmentDynamicActivity extends FragmentActivity { 

@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity fragment dynamic); 
PagerTabStrip pts tab = (PagerTabStrip) find ViewById(R.id.pts tab); 
pts. tab.setTextSize(TypedValue.COMPLEX UNIT SP, 20); 
ViewPager vp content = (ViewPager) findViewById(R.id.vp content); 
ArrayList«GoodsInfo- goodsList = GoodslInfo.getDefaultList(); 
MobilePagerAdapter adapter = new MobilePagerAdapter(getSupportFragmentManager(), 

goodsList); 
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vp. content.setAdapter(adapter); 
vp content.setCurrentItem(0); 
j 
运行 效果 如 图 5-25 所 示 , 看 起 来 Fragment 的 界面 与 上 一 节 ViewPager 的 效果 没什么 不 同 。 


vivo X6S 





OPPO R9plus 





J 


OPPO R9plus 4GB+64GB 内 存 版 金色 全 网 通 46 手 机 
双 卡 双 待 





525 动态 注册 的 Fragment 效果 
下 面 来 看 Fragment 的 生命 周期 。 惯 例 先 输出 代码 加 上 生命 周期 的 日 志 ， 然 后 观察 动态 注 
册 的 运行 日 志 。 下 面 是 打开 页 面 时 的 日 志 信 息 : 
12:28:28.074: D/FragmentDynamicActivity(5809): onCreate 


12:28:28.074: D/FragmentDynamicActivity(5809): onStart 
12:28:28.074: D/FragmentDynamicActivity(5809): onResume 


12:28:28.086: D/DynamicFragment(5809): 
12:28:28.086: D/DynamicFragment(5809): 
12:28:28.114: D/DynamicFragment(5809): 
12:28:28.114: D/DynamicFragment(5809): 
12:28:28.114: D/DynamicFragment(5809): 
12:28:28.114: D/DynamicFragment(5809): 
12:28:28.114: D/DynamicFragment(5809): 
12:28:28.114: D/DynamicFragment(5809): 
12:28:28.146: D/DynamicFragment(5809): 
12:28:28.146: D/DynamicFragment(5809): 
12:28:28.146: D/DynamicFragment(5809): 


下 面 是 退出 页 面 时 的 日 志 信息 : 


D/DynamicFragment(5809): 
D/DynamicFragment(5809): 


12:28:57.994: 
12:28:57.994: 


onAttach position-0 
onCreate position-0 
onCreateView position-0 
onActivityCreated position-0 
onStart position-0 
onResume position-0 
onAttach position-0 
onCreate position-0 
onCreateView position=1 
onStart position-1 
onResume position=1 


onPause position-0 
onPause position-l 


12:28:57.994: 
12:28:58.402: 
12:28:58.402: 


D/FragmentDynamicActivity(5809): onPause 
D/DynamicFragment(5809): onStop position-0 
D/DynamicFragment(5809): onStop position-l 
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12:28:58.402: D/FragmentDynamicActivity(5809): onStop 
12:28:58.402: D/DynamicFragment(5809): onDestroyView position-0 
12:28:58.402: D/DynamicFragment(5809): onDestroy position-0 
12:28:58.402: D/DynamicFragment(5809): onDetach position-0 
12:28:58.402: D/DynamicFragment(5809): onDestroyView position=1 
12:28:58.402: D/DynamicFragment(5809): onDestroy position=1 
12:28:58.402: D/DynamicFragment(5809): onDetach position-1 
12:28:58.402: D/FragmentDynamicActivity(5809): onDestroy 


日 志 搜集 完毕 ， 接 下 来 分 析 一 下 这 其 中 的 奥妙 。 笔 者 总 结 了 一 下 ， 主 要 有 以 下 三 点 : 


(1) 动态 注册 时 ，Fragment 的 onCreate 操作 在 Activity 之 后 ， 其 余 操作 的 先后 顺序 与 静 
态 注册 时 保持 一 致 。 

(2) 注意 onActivityCreated 方法 。 无 论 是 静态 注册 还 是 动态 注册 ， 该 方法 都 在 Activity 
的 onCreate 操作 之 后 。 可 见 该 方法 在 页 面 创建 之 后 才 调 用 。 

(3) 最 重要 的 一 点 ， 进 入 第 一 个 Fragment， 实 际 只 加 载 了 第 一 页 和 第 二 页 ， 并 没有 加 载 
全 部 Fragment。 这 正 是 Fragment 的 优越 之 处 ， 无 论 当前 位 于 哪 一 页 ， 系 统 都 只 会 加 载 当 前 页 
及 相 邻 的 前 后 两 页 ， 总 共 加载 不 超过 三 页 。 一 旦 发 生 页 面 切 换 ， 相 邻 页 面 就 被 加 载 ， 非 相 邻 页 
面 就 被 回收 。 这 么 做 的 好 处 是 节省 了 宝贵 的 系统 资源 , 只 有 用 户 正在 浏览 与 将 要 浏览 的 Fragment 
才 会 加 载 ， 避 免 所 有 Fragment 一 起 加 载 造成 资源 浪费 ， 这 正 是 普通 ViewPager 的 缺点 。 


5.4.3 ”改进 的 启动 引导 页 


接 下 来 把 Fragment 用 于 实战 ， 为 “5.3.3 简单 的 启动 引导 页 ”做 个 改进 。 与 之 前 相 比 ， 布 
局 文件 不 变 ， 改 动 的 都 是 代码 。 下 面 是 碎片 适配器 的 代码 : 
public class LaunchImproveAdapter extends FragmentStatePagerAdapter { 
private ArrayList<Integer> mlmageList = new ArrayList<Integer>(); 
public LaunchImproveA dapter(FragmentManager fm, int[] imageArray) í 
super(fm); 
for (int i0; icimageArray.length; i++) í 
mlmageList.add(imageA rray[i]); 








j 
h: 


public int getCount() í 
return mImageList.size(); 
bh 


public Fragment getltem(int position) í 
return LaunchFragment.newInstance(position, mImageList.get(position)); 
} 
; 


下 面 是 每 个 启动 页 的 Fragment 代码 : 
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public class LaunchFragment extends Fragment í 
protected View mView; 
protected Context mContext; 
private int mPosition; 
private int mlmageld; 
private int mCount = 4; 


public static LaunchFragment newlnstance(int position, int image id) { 
LaunchFragment fragment = new LaunchFragment(); 
Bundle bundle = new Bundle(); 
bundle.putInt("position", position); 
bundle.putInt("image id", image id); 
fragment.setArguments(bundle); 
return fragment; 


(@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { 

mContext = getActivity(); 
if (getArguments() != null) í 

mPosition = getArguments().getInt("position", 0); 

mlmageld = getArguments().getInt("image id", 0); 
j 
mView = inflater.inflate(R.layout.item launch, container, false); 
ImageView iv launch = (ImageView) mView.findViewByld(R.id.iv launch); 
RadioGroup rg indicate = (RadioGroup) mView.find ViewById(R.id.rg indicate); 
Button btn start = (Button) mView.findViewById(R.id.btn start); 
iv launch.setImageResource(mImageld); 
for (int j-0; j<mCount; j+) í 

RadioButton radio = new RadioButton(mContext); 

radio.setLayoutParams(new LayoutParams(LayoutParams. WRAP CONTENT, 

LayoutParams. WRAP. CONTENT)); 

radio.setButtonDrawable(R.drawable.launch guide); 

radio.setPadding(10, 10, 10, 10); 

rg indicate.add View(radio); 
b 
((RadioButton)rg_indicate.getChildAt(mPosition)).set Checked(true); 
if (mPosition — mCount-1) { 

btn start.setVisibility( View. VISIBLE); 

btn start.setOnClickListener(new OnClickListener() í 

(ajOverride 
public void onClick(View v) í 
Toast.makeText(mContext, "欢迎 开启 美好 生活 "， 
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Toas.LENGTH. SHORT).show(); 





5-26 Fragment 改造 后 的 启动 引导 页 


5.5 Broadcast 基础 


本 节 介 绍 为 何 使 用 广播 Broadcast 和 如 何 使 用 广播 ， 包 括 发 送 临时 广播 、 注 册 接 收 器 
BroadcastReceiver 接收 临时 广播 、 通过 定时 器 设置 定时 广播 、 在 AndroidManifest.xml 中 注册 接 
收 器 接收 系统 发 出 的 定时 广播 。 


5.5.1 发 送 /接收 临时 广播 


页 面 与 页 面 之 间 传递 和 传 回 消息 可 使 用 Intent。 页 面向 适配器 传递 消息 可 使 用 适配器 的 构 
造 函数 ， 适 配器 向 页 面 传 回 消息 有 点 麻烦 ， 在 “5.2.3 网 格 视图 GridView” 的 商品 频道 改造 时 
就 遇 到 了 ， 当 时 是 在 适配器 构造 函数 中 传 入 回调 接口 ,适配器 调用 回调 接口 的 方法 ,从 而 实现 
把 消息 传 回 页 面 。 页 面向 碎片 传递 消息 可 在 碎片 适配器 中 为 碎片 对 象 设置 情景 参数 〈 调 用 
setArguments 方法 ) 。 碎 片 如 何 把 消息 传 回 页 面 呢 ? 这 个 问题 看 起 来 很 高 深 ， 其 实 至 少 有 两 种 


“159。 
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(1) Fragment 提供 了 onAttach 方法 ，onAttach 方法 指定 了 结合 的 Activity 对 象 。 同 样 定 
义 一 个 回调 接口 , 把 Activity 对 象 强制 转换 为 回调 接口 就 可 以 在 碎片 中 调用 页 面 方法 。 这 种 方 
式 不 是 本 节 的 重点 ， 有 兴趣 的 读者 可 以 自行 钻研 。 

(2) 人 人 都 想 成 为 武林 高 手 ， 捷 径 之 一 就 是 寻找 武功 秘笈 。 同 样 是 武术 教材 ， 清 风 剑 法 
练 十 年 还 不 如 九 阴 真 经 练 一 年 。Android 隐藏 着 不 少 武林 大 法 ， 每 当 你 按照 常规 思路 难以 解决 
问题 时 ， 往 往 用 一 个 大 法 就 可 以 迎刃而解 。“5.2 列表 类 视图 ”在 处 理 ListView 与 GridView 
的 分 隔 线 时 便 用 到 了 padding 大 法 。 现 在 适配器 向 页 面 传 回 消息 有 一 个 Broadcast 大 法 ， 无 论 
对 方 在 何 处， 只 要 用 Broadcast 大 法 吼 一 吼 ， 对 方 立刻 能 够 听 到 ， 沁 不 妙 哉 ! 


广播 (Broadcast) 用 于 Android 组 件 之 间 的 灵活 通信 ， 与 Activity 的 区 别 在 于 : 


(1) Activity 只 能 一 对 一 通信 ; Broadcast 可 以 一 对 多 ， 一 人 发 送 广播 ， 多 人 接收 处 理 。 

(OD 对 于 发 送 者 来 说 ,广播 不 需要 考虑 接收 者 有 没有 在 工作 , 接收 者 在 工作 就 接收 广播 ， 
不 在 工作 就 丢弃 广播 。 

GO 对 于 接收 者 来 说 , 会 收 到 各 式 各 样 的 广播 所 以 接收 者 要 自行 过 滤 符 合 条 件 的 广播 ， 
才能 进行 解 包 处 理 。 


与 广播 有 关 的 方法 主要 有 以 下 3 个 。 


e sendBroadcast: 发 送 广播 。 
e registerReceiver: 注册 接收 器 ， 一 般 在 onStart 或 onResume 方法 中 注册 。 
e unregisterReceiver: 注销 接收 器 ， 一 般 在 onStop 或 onPause 方法 中 注销 。 


如 果 广 播 是 在 应 用 内 使 用 ， 不 需要 跨 进 程 ， 建 议 使 用 LocalBroadcastManager 下 的 
registerReceiver 与 unregisterReceiver 方法 ， 因 为 这 样 不 但 更 有 效率 〈 不 需要 跨 进 程 通 信 ) ， 而 
且 不 用 考虑 广播 开放 造成 的 安全 问题 〈 如 果 其 他 应 用 也 能 收 到 广播 ) 。 

为 说 明 广 播 的 工作 流程 ， 对 其 进行 具体 的 演示 。 现 在 Fragment 内 有 一 个 Spinner. 下 拉 框 ， 
可 选择 背景 颜色 ， 一 旦 选中 某 个 背景 色 ， 整 个 活动 页 面 的 背景 色 就 换 成 新 颜色 。Fragment 内 
部 发 现 选中 颜色 后 ， 要 发 送 一 个 背景 色 变更 的 广播 ， 代 码 如 下 : 

public final static String EVENT = "com.example.senior.fragment.BroadcastFragment"; 
private String[] mColorNameArray = {" 红 色 ", "黄色 ", "绿色 ", "青色 "," 蓝 色 "}; 
private int[] mColorIdArray= {Color.RED, Color.YELLOW, Color.GREEN, Color.CYAN, 
Color.BLUE]; 
class ColorSelectedListener implements OnlItemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View arg], int arg2, long arg3) í 
Intent intent — new Intent(BroadcastFragment.EVENT); 
intent.putExtra("color", mColorIdArray [arg2]); 
LocalBroadcastManager.getInstance(mContext).sendBroadcast(intent); 
; 





public void onNothingSelected(AdapterView-?- arg0) í 


* 160: 
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同时 ，Activity 代码 要 实现 背景 色 变更 的 广播 接收 器 。 一 旦 接收 到 背景 色 变更 的 广播 ， 就 
立即 修改 页 面 为 最 新 的 背景 色 ， 示 例 代码 如 下 : 


@Override 
public void onStart() í 
super.onStart(); 
bgChangeReceiver = new BgChangeReceiver(); 
IntentFilter filter = new IntentFilter(BroadcastFragment. EVENT); 
LocalBroadcastManager getInstance(this).registerReceiver(bgChangeReceiver, filter); 
j 


(@Override 

public void onStop() í 
LocalBroadcastManager.getInstance(this).unregisterReceiver(bgChangeReceiver); 
super.onStop(); 

j 


private BgChangeReceiver bgChangeReceiver; 
private class BgChangeReceiver extends BroadcastReceiver í 
@Override 
public void onReceive(Context context, Intent intent) { 
if (intent != null) { 
int color = intent.getIntExtra("color", Color. WHITE); 
ll brd temp.setBackgroundColor(color); 





} 
J 
; 
广播 效果 如 图 5-27 所 示 。 在 Fragment 内 部 选择 青色 ， 整 个 页 面 的 背景 色 都 变 了 。 
Mates 小 米 5 vivo X6S 
m we Ë 
e -8 


小 米 手机 5 全 网 通 高 配 版 3GB 内 存 64GB 白色 


图 5-7 Fragment 发 送 广播 ，Activity 接收 广播 





Android Studio fr £: 25%: 从 零 基础 到 App 上 线 





5.5.2 ”定时 器 AlarmManager 


AlarmManager 是 Android 提供 的 一 个 全 局 定时 器 ， 利 用 系统 闹钟 定时 发 送 广播 。 这 样 做 
的 好 处 是 : 如 果 App 提前 注册 六 钟 的 广播 接收 器 ， 即 使 App 退出 了 ， 只 要 定时 到 达 ，App 就 
会 被 唤醒 响应 广播 事件 。 是 不 是 很 神奇 ? App 都 不 在 了 还 能 自动 响应 ? 没 错 , 就 是 这 样 ， 要 不 
然 Broadcast 怎么 对 得 起 大 法 的 名 号 。 

下 面 来 看 这 种 奇妙 的 事情 是 如 何 实现 的 ,首先 在 页 面 代码 中 通过 AlarmManager 设置 闹钟， 
具体 代码 如 下 : 


@Override 
public void onClick(View v) { 
if (v.getId() — R.id.btn alarm) ( 
Intent intent = new Inteni(ALARM EVENT); 
PendingIntent pIntent = PendingIntent.getBroadcast(this, 0, intent, 
PendingInten.FLAG UPDATE CURRENT); 

AlarmManager alarmMgr = (AlarmManager) getSystemService(ALARM SERVICE); 
Calendar calendar — Calendar.getInstance(); 
calendar.setTimeInMillis(System.currentTimeMillis()); 
calendar.add(Calendar.SECOND, mDelay); 
alarmMgr.set(AlarmManager.RTC WAKEUP, calendar.getTimelInMillis(), pIntent); 
mDesc = DateUtil.getNowTime() +" 设置 闹钟 "; 
tv alarm.setText(mDesc); 








Ü: 
然后 在 页 面 代码 中 定义 一 个 广播 接收 器 AlarmReceiver， 示 例 代码 如 下 : 
private String ALARM_EVENT = "com.example.senior.AlarmActivity.AlarmReceiver"; 
private static String mDesc = ""; 
private static boolean bArrived = false; 
public static class AlarmReceiver extends BroadcastReceiver í 
@Override 
public void onReceive(Context context, Intent intent) { 
if (intent != null) { 
Log.d(TAG, "AlarmReceiver onReceive"); 
if (tv_alarm != null && bArrived = false) { 
bArrived = true; 
mDesc = String.format("%s\n%s W]PPES Tí] |i", mDesc, 
DateUtil.getNowTime()); 
tv alarm.setText(mDesc); 
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接着 打开 AndroidManifest.xml, fE application 节点 下 增加 广播 接收 器 的 声明 (注意 ， 凡 是 
在 AndroidManifest.xml 中 声明 的 ， 就 叫 静 态 注册 ;在 代码 中 声明 叫 动 态 注册 ) : 
<receiver android:name-".AlarmActivitySA larmReceiver" > 
<intent-filter> 
«action android:name="com.example.senior.AlarmActivity.AlarmReceiver" /> 
</intent-filter> 
</receiver> 


最 后 的 演示 界面 如 图 5-28 和 图 5-29 所 示 。 其 中 ， 图 5-28 是 开始 设置 闹钟 时 的 界面 ， 图 
5-29 是 收 到 疮 钟 广播 时 的 界面 。 


Senior Senior 


益 钟 延迟 5 秒 


设置 闹钟 


16:31:49 设置 闹钟 16:31:49 设置 闹钟 
16:31:54 闹钟 时 间 到 达 





528 ”开始 设置 闹钟 图 5-29” 收 到 闹钟 广播 

这 里 的 定时 器 能 够 完美 实现 广播 功能 ,就 是 AlarmManager 与 PendingIntent 相 互 配 合 的 成 果 。 

PendingIntent 的 意思 是 延迟 的 意图 ， 只 要 不 是 立即 传递 的 消息 ， 都 要 用 PendingIntent。 与 
之 相对 的 , 平常 我 们 使 用 Activity 与 Broadcast 传递 消息 都 要 求 立即 处 理 ， 所 以 用 Intent. [8] fl 
有 延迟 ， 所 以 必须 用 PendingIntent，PendingIntent 调用 了 getBroadcast 方法 ， 表 示 这 次 携带 的 
消息 用 于 发 送 广播 。 

AlarmManager 的 set 方法 用 于 设置 一 次 性 定时 器 , 方法 的 第 一 个 参数 表示 定时 器 类 型 (一 
般 是 AlarmManager.RTC_WAKEUP， 表 示 定 时 器 即使 在 睡眠 状态 下 也 会 启用 ) ， 第 二 个 参数 
表示 任务 的 执行 时 间 , 第 三 个 参数 表示 携带 消息 的 延迟 任务 (getBroadcast 返回 的 PendingIntent 
对 象 ) 。 


5.6 KRMH: 日 历 /日 程 表 


本 章 介绍 了 好 几 个 高 级 控件 ， 如 此 一 来 ， 实 战 项 目的 功能 也 变 得 较为 复杂 了 。 本 节 的 实 
战 项 目 “ 上 日 历 /日 程 表 ” 包 含 两 个 实战 项 目 ， 一 个 日 历 ， 一 个 日 程 表 。 通 过 实战 项 目的 练习 可 
以 更 好 地 掌握 高 级 控件 的 用 法 。 


5.6.1 设计 思 





手机 上 的 日 历 一 般 是 一 个 月 一 个 页 面 ， 一 年 12 个 月 就 是 12 个 页 面 。 日 历 展示 的 信息 有 
公历 日 、 农 历 日 ， 还 有 常见 节假日 和 二 十 四 节气 。 相 信 大 家 对 日 历 都 很 熟悉 ， 这 里 不 再 歼 述 。 
图 5-30 所 示 为 2016 年 10 月 份 的 日 历 页 ， 图 5-31 所 示 为 2016 年 12 月 份 的 日 历 页 。 
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图 5-30 2016 年 10 月 的 日 历 页 图 5-31 2016 年 12 月 的 日 历 页 
首先 数 一 数 日 历 项 目 用 到 了 本 章 的 哪些 新 知识 ， 只 看 效果 图 大 概 会 发 现 以 下 6 个 。 


(1) 网 格 视图 GridView: 每 月 的 日 期 项 采用 了 GridView, fr 7 列 。 

(2) 基本 适配器 BaseAdapter: 网 格 项 要 展示 公历 日 、 农 历 日 、 节 日 与 节气 ， 需 要 适配器 
配合 。 

G) 翻 页 视图 ViewPager: 一 年 12 个 月 ， 支 持 左右 滑 动 ， 用 到 了 ViewPager。 

(4) 碎片 Fragment: 12 个 月 对 应 12 个 页 面 ， 每 个 页 面 都 是 一 个 Fragment, 

C5) 碎片 适配器 FragmentStatePagerAdapter: 把 12 个 Fragment 组 装 到 ViewPager Po 

(6) 选项 卡 标题 栏 PagerTabStrip: 日 历 上 方 每 个 月 的 月 份 标题 ， 对 应 PagerTabStrip 。 


这 样 看 来 ， 日 历 项 目 覆盖 的 知识 点 有 点 少 ， 要 想 全 面 、 深 入 地 复习 本 章 的 大 部 分 知识 点 ， 
还 要 重新 设计 一 个 日 程 表 项 目 。 日 程 表 不 但 支持 基本 的 日 历 信息 展示 , 而 且 支 持 用 户 设 定 每 天 
的 日 程 安排 ， 还 支持 日 程 提醒 时 间 。 如 此 一 来 , 日 程 表 项 目 分 成 两 个 页 面 ,一 个 是 类 似 日 历 的 
主页 面 ， 另 一 个 是 查看 日 程 详情 的 页 面 。 图 5-32 所 示 为 日 程 表 的 主页 面 ， 因 为 要 展示 每 日 的 
日 程 摘要 ， 所 以 每 天 占用 一 行 、 一 个 页 面 展 示 七 行 ( 一 周 的 日 历 )。 点 击 每 行 日 历 进入 日 程 安 
排 页 面 ， 如 图 5-33 所 示 。 当 天 无 安排 就 新 增 日 程 ， 已 有 安排 就 查看 日 程 详情 。 













日 程 安排 

















: ”2016 年 10 月 2 日 农历 九 月 初 二 
星期 日 
: 0930 
提前 半 小 时 
AH: gun 
四 9H29H &InAHt:: 
今日 暂 无 日 程 安排 
星期 五 9 月 30 日 农历 八 月 州 十 
今日 暂 无 日 程 安排 
星期 六 10 月 1 日 农历 九 月 初 一 国庆 节 
今日 暂 无 日 程 安排 
星期 日 10 月 2 日 农历 九 月 初 二 
今日 蜀 无 日 程 安排 
图 5-32 日 程 表 主 页 面 图 5-33 日 程 表 详 情 页 


- 164 。 
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有 了 效果 图 ， 再 来 看 日 程 表 项 目 用 到 的 知识 点 ， 仔 细 找 找 你 会 发 现 几 个 ? 


e 列表 视图 ListView: 每 页 日 历 包含 7 天 ( 一 周 的 日 期 ) ， 采 用 了 ListView. 

e 基本 适配器 BaseAdapter: 列表 项 要 展示 当天 的 公历 日 、 农 历 日 、 节 日 与 节气 ， 还 要 展示 

当天 的 日 程 安 排 标题 ， 需 要 适配器 配合 。 

翻 页 视图 ViewPager: 每 页 一 周 ， 一 年 52 周 ， 支 持 左右 滑动 ， 用 到 了 ViewPager. 

碎片 Fragment: 52 周 对 应 52 个 页 面 ， 每 个 页 面 都 是 一 个 Fragment. 

碎片 适配器 FragmentStatePagerAdapter: 把 52 个 Fragment 组 装 到 ViewPager 中 。 

选项 卡 标题 栏 PagerTabStrip: 日 历 上 方 每 周 的 周 数 标题 对 应 PagerTabStrip。 

广播 Broadcast: 每 页 根据 当 周 的 节日 设置 背景 图 ， 如 国庆 节 所 在 周 显 示 华 表 背 景 ， 中 秋 

节 所 在 周 显示 圆 月 背景 ， 当 周 无 节日 显示 晴天 背景 。 由 Fragment 通知 Activity 变更 背景 ， 

上 一 节 说 过 可 用 广播 技术 ，Fragment 发 送 广播 ，Activity 接收 广播 。 

e 时 间 选 择 对 话 框 TimePickerDialog: 设置 日 程 安排 要 选择 日 程 时 间 ， 即 时 间 选 择 对 话 框 。 

e 定时 器 AlarmManager: 设置 日 程 提醒 时 间 ， 一 般 要 指定 提前 若干 分 钟 ， 这 个 定时 任务 就 
靠 AlarmManager。 


另外 , 还 包括 其 他 已 经 学 过 的 控件 知识 ， 如 TextView、Button、EditText、Spinner、SQLite 
等 ， 没 法 一 一 列举 ， 有 待 读者 在 实战 中 继续 巩固 提高 。 
562 ”小 知识 : 震动 器 Vibrator 

上 面 日 程 提醒 可 采用 手机 震动 的 方式 ， 会 用 到 震动 器 Vibrator， 对 象 从 系统 服务 
VIBRATOR SERVICE 中 获取 。 震 动 器 的 主要 方法 如 下 : 

e hasVibrator: 判断 设备 是 否 拥 有 震动 器 。 

e vibrate: 震动 手机 。 可 设 定单 次 震动 的 时 长 、 多 次 震动 的 时 长 、 是 否 重 复 震 动 等 。 

e cancel: 取消 震动 。 

使 用 震动 器 要 在 AndroidManifest.xml 中 加 上 如 下 权限 : 

<!-- 震动 -> 
<uses-permission android:name-"android.permission. VIBRATE" /> 
控制 手机 震动 的 代码 很 简单 ， 下 面 短 短 两 行 就 实现 了 震动 功能 。 
Vibrator vibrator = (Vibrator) getSystemService(Context.VIBRATOR_ SERVICE): 
vibratorvibrate(3000); /持续 震动 3 秒 

5.6.3 ”代码 示例 

本 章 的 实战 项 目 采 用 了 大 量 适 配器 与 碎片 ， 此 时 不 仅 需要 考虑 具体 编码 ， 还 得 考虑 代码 
的 架构 。 因 为 适配器 和 碎片 都 分 布 在 单独 的 代码 文件 中 , 所 以 有 必要 用 另外 的 package 包 管理 ， 
这 样 不 会 跟 Activity 文件 混在 一 起 。 

于 是 ， 接 下 来 的 编码 过 程 多 出 了 一 步 ， 共 分 为 5 步 。 

ED 设计 代码 架构 。 初 步 拆 分 后 的 package 包 分 为 以 下 7 部 分 。 





ETE 
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com.example.schedule.activity: 存放 Acitivity 页 面 的 代码 。 
com.example.schedule.adapter: 存放 适配器 的 代码 ， 包 括 基本 适配器 和 碎片 适配器 。 
com.example.schedule.bean: 存放 实体 数据 结构 的 代码 ， 如 日 程 表 的 字段 信息 。 
com.example.schedule.database: 存放 读 写 SQLite 的 数据 库 操作 代码 。 
com.example.schedule.fragment: 存放 碎片 代码 。 

com.example.schedule.receiver: 存放 广播 接收 器 的 代码 。 

com.example.schedule.util: 存放 工具 类 的 代码 。 


本 章 的 演示 工程 因为 加 入 了 许多 示例 代码 , 所 以 包 名 与 相关 结构 与 上 述 package 架构 不 
尽 相 同 ， 这 是 难以 避免 的 。 实 战 项 目 作为 一 个 独立 的 App， 不 应 混入 其 他 无 关 代码 ， 建 
议 读者 自己 开发 时 按照 更 清晰 的 package 架构 编码 。 


EIO 想 好 代码 文件 与 布局 文件 的 名 称 。 比 如 日 历 页 面 的 代码 文件 取 名 CalendarActivityjava, 
对 应 的 布局 文件 是 activity_calendar.xml; 日 程 表 页 面 的 代码 文件 取 名 ScheduleActivityjava， 对 应 的 布 
局 文件 是 activity_schedule.xml; 日 程 详情 页 面 的 代码 文件 取 名 ScheduleDetailActivityjava， 对 应 的 布 
局 文件 是 activity_schedule_detail.xml; 另外 ， 还 有 一 个 全 局 应 用 的 代码 文件 MainApplicationjava。 不 
要 忘 了 闹钟 广播 接收 器 的 代码 文件 AlarmReceiverjava, 还 有 适配器 与 碎片 的 代码 及 其 布局 文件 , 读者 
可 自行 构思 。 

JI03 在 AndroidManifest.xml 中 补充 相应 配置 。 在 AndroidManifest.xml 中 补充 相应 配置 ， 主 
要 有 以 下 3 点 。 


(1) 注册 3 个 页 面 的 acitivity 节点 ， 注 册 代码 如 下 : 
<activity android:name=".activity.CalendarActivity" /> 
<activity android:name=".activity.ScheduleActivity" /> 
«activity android:name=".activity.ScheduleDetailActivity" /> 


(2) 注册 闹钟 接收 器 的 receiver 节点 ， 注 册 代码 如 下 : 


注意 











«receiver android:name=" receiver.AlarmReceiver" > 
<intent-filter> 
«action android:name-"com.example.senior.ScheduleDetailActivity.A larmReceiver" /> 
«/intent-filter- 
«receiver 
(3) 声明 手机 震动 的 操作 权限 。 


EI 在 resdrawable 目录 加 入 日 程 表 用 到 的 背景 图 ， 在 res/layout 目录 下 编写 布局 文件 。 
EI 进行 java 代码 开发 ， 包 括 页 面 、 适 配器 、 碎 片 、 广 播 接收 器 等 编码 。 与 日 历 有 关 的 公 
历 计 算 、 农 历 计算 、 二 十 四 节气 计算 都 有 相应 的 开源 代码 ， 这 里 只 需 完成 控件 操作 代码 。 


编码 完成 后 ， 日 程 表 主页 面 应 该 能 够 展示 每 日 的 日 程 安排 文字 ， 如 图 5-34 所 示 。 


ZU 
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今日 暂 无 日 程 安排 


9 月 30 日 农历 八 月 州 十 
17 时 00 分 ; 坐 高 铁 





星期 六 10 月 1 日 农历 九 月 初 一 国庆 节 
今日 暂 无 日 程 安排 


星期 日 10 月 2 日 农历 九 月 初 二 
098305) : 去 海边 玩 
图 5-34 日 程 表 主页 面 显示 每 日 的 日 程 安排 
下 面 是 日 程 详情 页 面 ScheduleDetailActivity.java 的 主要 代码 片段 : 


private String[] alarmArray = {" 不 提醒 ", "提前 5 分 钟 ", "提前 10 分 钟 ", 
"提前 15 分 钟 ", "提前 半 小 时 ", "提前 1 小 时 ", "当前 时 间 后 10 秒 "}; 
private int[] advanceArray = {0, 5, 10, 15, 30, 60, 10}; 
private int alarmType = 0; 
class AlarmSelectedListener implements OnltemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) { 
alarmType = arg2; 


public void onNothingSelected(AdapterView-?- arg0) í 
] 


@Override 
protected void onResume() í 
super.onResume(); 
arrange = new ScheduleArrange(); 
arrangeHelper = new ScheduleArrangeHelper(this, DbHelper.db_name, null, 1); 
List<ScheduleArrange> arrangeList = (List<ScheduleArrange>) 
arrangeHelper.querylnfoByDay(day); 
if (arrangeList.size() >= 1) ( 
enableEdit(false); 
arrange = arrangeList.get(0); 
schedule time.setText(arrange.hour+":"+arrange.minute); 
schedule alarm.setSelection(arrange.alarm type); 
schedule title.setText(arrange.title); 
schedule content.setText(arrange.content); 
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} else í 
enableEdit(true); 
J 
h 
@Override 
protected void onPause() { 
super.onPause(); 
arrangeHelper.close(); 
i 
@Override 


public void onClick(View v) { 
int resid = v.getld(); 
if (resid = R.id.schedule time) í 
Calendar calendar = Calendar.getInstance(); 
TimePickerDialog dialog = new TimePickerDialog(this, this, 
calendar.get(Calendar. HOUR_OF_DAY), calendar.get(Calendar. MINUTE), 
true); 
dialog.show(); 
) else if (resid = R.id.btn_back) í 
finish(); 
} else if (resid = R.id.btn edit) { 
enableEdit(true); 
} else if (resid = R.id.btn save) í 
if (schedule title.getText().toString().equals("") = true) í 
Toast.makeText(this, "请 输入 日 程 标题 ", Toas.LENGTH. SHORT).show(); 
return; 
j 
enableEdit(false); 
String[] time split = schedule time.getText().toString().split(":"); 
arrange.hour = time split[0]: 
arrange.minute = time split[1]; 
arrange.alarm type = alarmType; 
arrange.title — schedule title.getText().toString(); 
arrange.content = schedule content.getText().toString(); 
if (arrange.xuhao <= 0) í 
arrange.month — month; 
arrange.day — day; 
arrangeHelper.add(arrange); 
} else í 
arrangeHelper.update(arrange); 
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Toast.makeText(this, "保存 日 程 成 功 ", Toast.LENGTH_SHORT).show(); 
// 设 置 提醒 闹钟 
if (alarmType > 0) í 
Intent intent = new Inteni(ALARM EVENT); 
PendingIntent pIntent = PendingIntent.getBroadcast(this, 0, intent, 
PendingInten.FLAG UPDATE CURRENT); 
AlarmManager alarmMgr = (AlarmManager) getSystemServic(ALARM SERVICE); 
Calendar calendar = Calendar.getInstance(); 
if (alarmType == 6) í 
calendar.setTimeInMillis(System.currentTimeMillis()); 
calendar.add(Calendar.SECOND, advanceArray [alarmType]); 
) else ( 
int day int = Integer parseInt(day); 
calendarset(day int/10000, day int?610000/100-1, day int?6100, 
Integer. parselnt(arrange.hour), Integer.parseInt(arrange.minute), 0); 
calendar.add(Calendar.SECOND, -advanceArray [alarmType]*60); 


j 
alarmMgr.set(AlarmManager.RTC WAKEUP, calendar.getTimeInMillis(), pIntent); 


(a Override 

public void onTimeSet(TimePicker view, int hourOfDay, int minute) í 
String time = String.format("%02d:%02d", hourOfDay, minute); 
schedule time.setText(time); 


private String ALARM EVENT = "com.example.senior.ScheduleDetailActivity.AlarmReceiver"; 
public static class AlarmReceiver extends BroadcastReceiver í 
@Override 
public void onReceive(Context context, Intent intent) { 
if (intent != null) { 
Log.d(TAG, "AlarmReceiver onReceive"); 
Vibrator vibrator = (Vibrator) 
context.getSystemService(Context.VIBRATOR_SERVICE); 
vibrator.vibrate(3000); // 默认 震动 3 秒 
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5.7 小 结 


本 章 主要 介绍 了 App 开发 的 高 级 控件 相关 知识 ， 包 括 日 期 时 间 控 件 的 用 法 (日 期 选择 器 、 
时 间 选 择 器 ) 、 列 表 类 视图 的 用 法 〈 基 本 适配器 、 列 表 视 图 、 网 格 视 图 ) 、 翻 页 类 视图 的 基本 
用 法 ( 翻 页 视图 、 翻 页 适配器 、 翻 页 标题 栏 )、 碎 片 的 用 法 (静态 注册 方式 、 动 态 注册 方式 、 
碎片 适配器 ) . Broadcast 组 件 的 基本 用 法 〈 发 送 广播 、 接 收 、 定 时 器 广播 ) 。 中 间 穿 插 了 实 
战 模块 的 运用 ， 如 改进 后 的 购物 车 、 改 进 后 的 启动 引导 页 等 。 最 后 设计 了 一 个 实战 项 目 “ 日 历 
/日 程 表 ”， 在 该 项 目的 App 编码 中 ， 采 用 本 章 介绍 的 大 部 分 控件 与 适配器 ， 以 及 广播 发 送 和 
广播 接收 器 的 处 理 。 另 外 ， 介 绍 了 震动 器 的 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 3 种 开发 技能 : 


CD 在 布局 文件 中 合理 使 用 本 章 学 到 的 控件 。 
(2) 在 代码 中 合理 调用 本 章 学 到 的 控件 和 适配器 的 相关 方法 。 
G) 学 会 Broadcast 组 件 的 用 法 ， 如 在 不 同 组 件 之 间 发 送 与 接收 广播 、 设 置 定时 器 并 接 


收 定时 器 广播 等 。 





EV 





IP 自 定义 控件 


本 章 介 绍 App 开发 经 常 涉及 的 自 定义 控件 相关 技术 ， 
主要 包括 自 定义 视图 的 过 程 与 步骤 、 自 定义 动画 的 原理 与 实 
现 、 自 定义 对 话 框 的 概念 与 示例 、 自 定义 通知 栏 的 用 法 与 定 
制 ， 另 外 介绍 四 大 组 件 之 一 的 Service 的 生命 周期 与 启 停 方 
式 。 最 后 结合 本 章 所 学 的 知识 ,演示 一 个 实战 项 目 “ 手 机 安 
全 助手 ”的 设计 与 实现 。 





DA GR 
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本 节 介 绍 自 定 义 视图 的 过 程 ， 包 括 声明 属性 与 编写 代码 两 个 过 程 。 编 写 代 码 的 过 程 分 为 
构造 对 象 、 测 量 尺寸 、 绘 制 视图 3 个 步骤 。 另 外 , 详细 说 明 绘 制 视图 的 3 种 途径 : 重 写 onLayout 
方法 、 重 写 onDraw 方法 和 重 写 dispatchDraw 方法 。 


6.1.1 声明 属性 


Android 自 带 的 视图 有 时 无 法 满足 实际 需求 ， 这 种 情况 下 开发 者 就 得 自 定 义 视图 。 自 定义 
视图 好 比 自己 造 车 ， 造 车 总 比 开 车 难 很 多 ,不 过 只 要 找到 窗 门 ， 其 实 也 没有 想象 得 那么 难 。 自 
定义 视图 涉及 许多 概念 ,为 了 使 读者 更 容易 理解 ， 下 面 从 一 个 小 例子 入 手 , 先 产 生 感 性 认识 
学 习 理 论 知 识 。 

第 5 章 提 到 PagerTitleStrip 和 PagerTabStrip 无 法 在 布局 文件 中 指定 文字 样式 , 只 能 在 代码 
中 设置 让 人 很 不 习惯 ,如 果 可 以 直接 指定 textColor 和 textSize 属性 就 会 好 很 多 。 现在 我 们 小 
试 牛 刀 ， 扩 展 自 定义 属性 ， 以 满足 在 布局 文件 指定 属性 的 要 求 。 具 体 步 又 如 下 : 

Ut 在 reswalues 目录 下 创建 attrs.xml。 其 中 ，declare-styleable 的 name 属性 值 表示 新 视图 名 
为 PagerTab， 两 个 attr 节点 表示 新 增 的 两 个 属性 分 别 是 textColor 和 textSize。 文 件 内 容 如 下 : 








<resources> 
<declare-styleable name="PagerTab"> 
<attr name-"textColor" format-"color" /> 
<attr name-"textSize" format="dimension" /> 
</declare-styleable> 
</resources> 


E 在 代码 目录 中 创建 PagerTabjava， 填 入 以 下 代码 : 


public class PagerTab extends PagerTabStrip { 
private int textColor = Color.BLACK; 
private int textSize = 15; 


public PagerTab(Context context) í 
super(context); 
bh 


public PagerTab(Context context,AttributeSet attrs) { 
super(context, attrs); 
if (attrs != null) í 
TypedArray attrArray=getContext().obtainStyledAttributes(attrs, R.styleable.PagerTab); 
textColor = attrArray.getColor(R.styleable.PagerTab textColor, textColor); 
textSize = attrArray.getDimensionPixelSize(R.styleable.PagerTab textSize, textSize); 
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attrArray.recycle(); 
j 

Ë 

@Override 

protected void onDraw(Canvas canvas) { 
setTextColor(textColor); 
setTextSize(TypedValue. COMPLEX UNIT SP, textSize); 
super.onDraw(canvas); 

} 


$ 

ED” 在 布局 文件 根 节点 增加 命名 空间 声明 xmlns:app="http://schemas.android.com/ 
apk/res-auto", 并 把 android.support.v4.view.PagerTabStrip 的 节点 名 称 改 为 自 定义 视图 的 全 路 径 名 称 (如 
com.example.custom.widget.PagerTab) ， 同 时 在 该 节点 下 指定 新 增 的 两 个 属性 一 一 app:textColoe 与 
app:textSize。 修 改 后 的 布局 文件 代码 如 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


xmins:app-"http://schemas.android.com/apk/res-auto" 
android:layout width-"match parent" 
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android:layout height-"match parent" 
android:orientation-" vertical" 
android:padding-" 10dp" > 
«android.support.v4.view.ViewPager 
android:id-"(a)*id/vp content" 
android:layout width-"match parent" 
android:layout height-"400dp" > 
*«com.example.custom.widget.PagerTab 
android:id-"(a)*id/pts tab" 
android:layout width-"wrap content" 
android:layout height-"wrap content" 
app:textColor-"(g)color/red" 
app:textSize-"17sp" /> 
«/android.support.v4.view.ViewPager- 
</LinearLayout> 


完成 以 上 代码 的 修改 后 运行 App, 实现 的 效果 如 图 6-1 所 示 ， 此 时 翻 页 标题 栏 的 文字 颜色 
变 为 红色 ， 字 体 也 变 大 了 。 

在 自 定义 视图 的 步骤 1 P, attr 节点 的 name 表示 新 属性 的 名 称 ，format 表示 新 属性 的 格 
式 〈 数 据 类 型 ) ; 在 步骤 2 中 ， 调 用 getColor 方法 获取 颜色 值 ， 调 用 getDimensionPixelSize 
方法 获取 文字 大 小 , 不 同 的 数据 类 型 调用 不 同 的 获取 方法 。 有 关 属 性 类 型 及 其 获取 方法 的 对 应 
说 明 见 表 6-1。 
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图 6-1 自 定义 的 翻 页 标题 栏 
表 6-1 属性 类 型 的 取 值 说 明 

















属性 类 型 获取 方法 说 明 
boolean getBoolean 布尔 值 。 取 值 为 true 或 false 
integer getlnt 整 型 值 
float getFloat 浮 点 值 
string getString 字符 串 
color getColor 颜色 值 。 取 值 为 开头 带 # 的 六 位 或 八 位 十 六 进 制 数 
dimension getDimension 尺寸 值 。 取 值 为 末尾 带 dp 的 尺寸 数值 
dimension getDimensionPixelSize 字体 大 小 。 取 值 为 末尾 带 sp 的 尺寸 数值 
fraction getFraction 百分数 。 取 值 为 末尾 带 % 的 百分数 
reference getResourceld 参考 某 一 资源 。 取 值 如 @drawable/ic_ launcher 
enum getint 枚 举 值 
flag getlnt 标志 位 
表 6-1 的 enum 类 型 与 flag 类 型 的 使 用 稍微 复杂 ， 枚 举 类 型 的 属性 常见 的 有 LinearLayout 


的 orientation 和 ImageView 的 scaleType: 标志 类 型 的 属性 常见 的 有 TextView 的 gravity 和 
EditText 的 inputType。 下 面 是 枚 举 类 型 的 属性 声明 : 


<declare-styleable name="PagerTab"> 
<attr name="customOrientation"> 
«enum name-"horizontal" value="0" /> 
<enum name="vertical" value="1" > 
</attr> 
</declare-styleable> 


下 面 是 标志 类 型 的 属性 声明 : 


<declare-styleable name="PagerTab"> 
<attr name="customGravity"> 
<flag name = "center" value = "0" /> 
«flag name = "left" value = "1" /> 
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«flag name = "top" value = "2" /> 
<flag name = "right" value = "4" /> 
«flag name = "bttom" value = "8" > 
</attr> 
</declare-styleable> 


6.1.2 ”构造 对 象 


新 增 视图 属性 的 声明 很 简单 ， 麻 烦 的 是 在 代码 中 进行 视图 的 自 定义 处 理 。 自 定义 视图 的 
编码 主要 由 3 部 分 组 成 : 







(1) 重 写 构造 函数 ， 初 始 化 该 视图 的 自 有 属性 。 
(2) 重 写 测量 函数 onMesure， 计 算 该 视图 的 宽 与 高 (一般 只 有 复杂 视图 才 重 写 该 函数 ) 。 
G) 重 写 绘图 函数 onLayout、onDraw、dispatchDraw， 视 情况 重 写 3 个 中 的 一 个 或 多 个 。 








- 般 要 重 写 3 个 构造 函数 。 前 面 在 演示 新 控件 PagerTab 时 ， 示 例 代码 给 出 了 3 个 构造 函 
数 〔 实 际 只 实现 了 两 个 ) ， 分 别 是 : 

a) 只 带 一 个 参数 的 public PagerTab(Context context)。 在 代码 中 声明 对 象 时 采用 该 构造 
函数 。 

(2) 带 两 个 参数 的 public PagerTab(Context context,AttributeSet attrs)。 在 布局 文件 中 引用 
自 定义 视图 时 采用 该 构造 函数 。 

(3) 带 3 个 参数 的 public PagerTab(Context context, AttributeSet attrs, int defStyleAttr)。 该 
构造 函数 的 作用 是 : 除了 布局 文件 中 指定 的 属性 ， 另 外 在 代码 中 指定 默认 风格 。 第 3 个 参数 
defStyleAttr 是 一 种 特殊 属性 ， 类 型 既 非 整 型 也 非 字 符 串 ， 而 是 参照 类 型 (reference, mE 
styles.xml 中 另外 定义 ) 。 有 具体 使 用 步骤 如 下 : 

KD £ stylesxml 中 定义 一 种 风格 样式 。 
在 attrsxml 中 声明 该 风格 样式 的 参照 属性 ， 举 例如 下 : 


<attr name="CustomizeStyle" format="reference" /> 
EI 在 代码 中 由 第 二 种 构造 函数 调用 第 三 种 构造 函数 , 在 调用 时 把 该 参照 属性 传 到 第 三 个 参 
数 中 ， 示 例 代码 如 下 : 


public PagerTab(Context context, AttributeSet attrs) { 
this(context, attrs, R.attr.CustomizeStyle); 





» 
public PagerTab(Context context, AttributeSet attrs, int defStyleAttr) í 
super(context, attrs, defStyleAttr); 
if (attrs !— null) í 


TypedArray attrArray = getContext().obtainStyledA ttributes( attrs, R.styleable.PagerTab, 
defStyleAttr, R.style.DefaultCustomizeStyle); 
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/此 处 省 略 各 个 属性 值 的 读 取 
attrArray.recycle(); 
j 


这 样 ， 系 统 在 寻找 该 视图 的 属性 时 就 会 先 找 布局 文件 ， 再 找 attrs.xml 中 声明 的 
Rattr.CustomizeStyle 风格 样式 ,最 后 找 styles.xml 中 R.style.DefaultCustomizeStyle 的 风格 样式 。 
第 三 种 构造 函数 用 的 不 多 ， 无 须 深 入 研究 ， 了 解 即 可 。 


6.1.3 测量 尺寸 


自 定义 视图 的 第 二 步 是 测量 尺寸 。 大 家 知道 ， 添 加 视图 的 目的 是 在 屏幕 上 显示 期 望 的 图 
案 。 如 此 ， 在 绘制 图 案 之 前 系统 得 先知 道 这 个 图 案 的 尺寸 , 即 宽 和 高 。 一 般 在 布局 文件 中 对 视 
图 的 宽 和 高 有 3 种 赋值 方式 ， 具 体 说 明 见 表 6-2。 


表 6-2 ”尺寸 大 小 的 3 种 赋值 方式 





XML 中 的 尺寸 类 型 LayoutParams 类 的 尺寸 类 型 说 明 
match parent MATCH PARENT 与 上 级 视图 大 小 一 样 


**dp 整 型 数 


方式 1 和 方式 3 都 好 办 ， 要 么 取 上 级 视图 的 数值 ， 要 么 取 具 体 数值 。 难 办 的 是 方式 2， 这 
个 尺寸 究竟 要 如 何 度量 ， 不 可 能 让 开发 者 人 手 一 把 尺子 在 屏幕 上 比划 。Android 提供 了 相关 度 
量 方法 ， 可 以 在 不 同情 况 下 进行 尺寸 测量 。 需 要 测量 的 对 象 主要 有 3 种 , 分 别 是 文本 尺寸 、 图 
形 尺寸 和 布局 尺寸 。 


1. 文本 尺寸 测量 


文本 尺寸 分 为 文本 的 宽度 和 高 度 ， 要 根据 文本 大 小 分 别 进行 计算 。 其 中 ， 文 本 宽度 使 用 
Paint 类 的 measureText 方法 测量 ， 具 体 代 码 如 下 : 


public static float getTextWidth(String text, float textSize) { 
if (text==null || text.length()<=0) í 
return 0; 
j 
Paint paint = new Paint(); 
paint.setTextSize(textSize); 
return paint.measureText(text); 





i 


文本 高 度 的 计算 要 烦琐 一 些 , 用 到 了 FontMetrics 28, 该 类 提供 了 5 个 与 高 度 相关 的 属性 ， 
详细 说 明 见 表 6-3. 
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表 6-3 ”FontMetrics 类 的 距离 属性 说 明 

















FontMetrics 类 的 距离 属性 说 明 

top 行 的 顶部 与 基线 的 距离 
ascent 字符 的 顶部 与 基线 的 距离 
descent 字符 的 底部 与 基线 的 距离 
bottom 行 的 底部 与 基线 的 距离 
leading 行 间距 








之 所 以 区 分 这 些 属 性 ， 是 为 了 计算 不 同 规格 的 高 度 。 如 果 要 得 到 文本 自身 的 高 度 ， 高 度 
值 就 是 descent WA ascent; 如 果 要 得 到 文本 所 在 行 的 行 高 ， 高 度 值 就 是 bottom 减 去 top 再 加 


上 leading。 具 体 的 高 度 计 算 代码 如 下 : 


public static float getTextHeight(String text, float textSize) { 


Paint paint = new Paint(); 


paint.setTextSize(textSize); 
FontMetrics fm = paint.getFontMetrics(); 


return fm.descent -fm.ascent; // 文 本 自身 的 高 度 


//return fm.bottom - fm.top + fm.leading; 


1 


/文本 所 在 行 的 行 高 


下 面 看 看 文本 尺寸 的 度量 结果 ， 当 字体 大 小 为 17sp 时 , 示例 文本 的 宽度 为 119、 高 度 为 19, 
如 图 6-2 所 示 ; 当 字体 大 小 为 25sp 时 ， 示 例文 本 的 宽度 为 175、 高 度 为 29， 如 图 6-3 所 示 。 


Custom 


字体 大 小 : 17sp 


下 面 文字 的 宽度 是 119 ,高 度 是 19 
每 逢 佳节 倍 思 亲 


图 6-2 字体 大 小 为 17sp 时 的 尺寸 


2. 图 形 尺寸 测量 


Custom 


字体 大 小 : 25sp 
下 面 文字 的 宽度 是 175 ,高 度 是 29 


每 着 佳节 倍 思 亲 
图 6-3 字体 大 小 为 25sp 时 的 尺寸 





相对 于 文本 尺寸 ， 图 形 尺 寸 的 计算 反而 简单 些 ， 因 为 Android 提供 了 可 以 直接 使 用 的 宽 、 
高 获取 方法 。 如 果 图 形 是 Bitmap 格式 ， 就 通过 getWidth 和 getHeight 方法 获取 位 图 对 象 的 宽 
度 和 高 度 ， 如 果 图 形 是 Drawable 格式 ,就 通过 getIntrinsicWidth 方法 获取 该 图 形 的 宽度 ， 通 过 


getIntrinsicHeight 方法 获取 该 图 形 的 高 度 。 


3. 布局 尺寸 测量 


文本 尺寸 测量 主要 用 于 TextView、Button 等 文本 控件 ,图 形 尺寸 测量 主要 用 于 ImageView、 
ImageButton 等 图 像 控 件 。 在 实际 开发 中 ， 有 更 多 场合 需要 测量 布局 视图 的 尺寸 。 布 局 视图 内 
部 可 能 有 文本 控件 、 图 像 控件 ， 还 可 能 有 padding 和 margin。 如 此 一 来 ， 对 布局 视图 的 内 部 控 
件 一 个 个 单独 测量 变 得 不 切实 际 。View 类 提供 了 一 种 对 布局 整体 进行 测量 的 思路 。 对 应 
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layout width 和 layout height 的 3 种 赋值 方式 ，Android 的 视图 提供 了 3 种 测量 模式 ， 具 体 取 











值 说 明 见 表 6-4。 
表 6-4 ”测量 模式 的 取 值 说 明 
MeasureSpec 类 的 测量 模式 视图 宽 、 高 的 赋值 方式 说 明 
AT MOST MATCH PARENT 达到 最 大 
UNSPECIFIED WRAP CONTENT 未 指定 〈 实 际 就 是 自 适应 ) 
EXACTLY 具体 dp f 精确 尺寸 








围绕 这 3 种 模式 衍生 了 相关 度量 方法 ， 如 ViewGroup 类 的 getChildMeasureSpec 方法 、 
MeasureSpec 类 的 makeMeasureSpec 方法 、View 类 的 measure 方法 等 。 具 体 的 测量 原理 可 以 不 
用 深究 ， 下 面 直接 切入 正题 ， 看 下 测量 尺寸 的 实现 代码 : 


public static float getRealHeight(View child) { 
LinearLayout llayout = (LinearLayout) child; 
ViewGroup.LayoutParams params = llayout.getLayoutParams(); 
if (params == null) í 
params = new ViewGroup.LayoutParams( 
LayoutParams.MATCH PARENT, LayoutParams.WRAP CONTENT); 
5 
int widthSpec = ViewGroup.getChildMeasureSpec(0, 0, params.width); 
int heightSpec; 
if (params.height > 0) í 
heightSpec = View.MeasureSpec.makeMeasureSpec(params.height, 
MeasureSpec.EXACTLY); 
) else í 
heightSpec = View.MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED); 
J 
llayout.measure(widthSpec, heightSpec); 
return llayout.getMeasuredHeight(); / 获得 布局 高 度 ， 获 得 布局 宽度 可 调用 
getMeasured Width 
5 


现在 很 多 App 页 面 都 提供 下 拉 刷 新 功能 ， 需 要 计算 下 拉 刷 新 的 头 部 高 度 ， 以 便 在 下 拉 时 
判断 整个 页 面 要 拉动 多 少 距离 。 下 面 演示 下 拉 刷 新 的 头 部 高 度 ， 如 图 6-4 所 示 。 头 部 布局 中 有 
图 像 、 文 字 和 间隔 ， 调 用 getRealHeight 方法 计算 得 到 的 布局 高 度 为 170。 


Custom 


E 


de 
炳 “ 轻 轻 下 拉 ， 刷 新 精彩 … 





上 面 下 拉 刷 新 头 部 的 高 度 是 170.000000 


图 6-4 布局 视图 的 高 度 测 量 结果 
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64.4 ”绘制 视图 


在 自 定义 视图 中 ， 可 重 写 3 个 函数 用 于 视图 的 绘制 ， 分 别 是 onLayout、onDraw 和 
dispatchDraw。 这 3 个 函数 的 执行 顺序 是 onLayout- onDraw— dispatchDraw. HF, onLayout 
和 dispatchDraw 通常 用 于 布局 类 视图 。 下 面 逐 一 介绍 这 3 个 函数 的 用 途 与 用 法 。 


























1. onLayout 


onLayout 方法 用 于 定位 子 视图 在 本 布局 视图 中 的 位 置 。 该 方法 的 入 参 表示 本 布局 在 上 级 
视图 的 上 、 下 、 左 、 右 位 置 ， 子 视图 在 本 布局 中 的 位 置 要 另行 计算 ， 计 算 完 毕 调用 子 视图 的 
layout 方法 调整 子 视图 的 位 置 。 

为 直观 理解 onLayout 的 用 法 ， 下 面 给 出 自 定义 偏 移 布局 的 代码 : 


public class OffsetLayout extends AbsoluteLayout { 
private int mOffsetHorizontal = 0, mOffsetVertical = 0; 
public OffsetLayout(Context context) í 
super(context); 


} 


public OffsetLayout(Context context,AttributeSet attrs) { 
super(context, attrs); 


(@Override 
protected void onLayout(boolean changed, int 1, int t, int r, int b) í 
int count = getChildCount(); 
for (inti = 0; i < count; i^) { 
View child = getChildAt(i); 
if (child.getVisibility() != GONE) í 
int new left = (r-1)/2-child.getMeasuredWidth()/2*-mOffsetHorizontal; 
int new top = (b-t)/2-child.getMeasuredHeight()/2*-mOffset Vertical; 
child.layout(new left, new top, 
new left*child.getMeasuredWidth(), new top*child.getMeasuredHeight()); 


h 


public void setOffsetHorizontal(int offset) í 
mOffsetHorizontal = offset; 
mOffsetVertical = 0; 
requestLayout(); 


public void setOffsetVertical(int offset) í 
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mOffsetHorizontal = 0; 
mOffsetVertical = offset; 
requestLayout(); 


; 

该 偏 移 布局 可 根据 设 定 的 偏 移 值 动态 调整 子 视图 的 偏 移 位 置 。 页 面 代 码 可 直接 调用 
OffsetLayout 对 象 的 setOffsetHorizontal 方法 或 setOffsetVertical 方法 ， 完 成 水 平 或 垂直 方向 的 
偏 移 值 设置 。 如 图 6-5 一 图 6-8 所 示 ， 这 4 张 图 分 别 展示 了 不 同 偏 移 值 的 效果 。 其 中 ， 图 6-5 
所 示 为 无 偏 移 ， 图 6-6 所 示 为 向 左 偏 移 100, 图 6-7 所 示 为 向 右 偏 移 100, 图 6-8 所 示 为 向 上 偏 
移 100。 

















ar 








Custom 





Custom 





偏 移 大 小 : 无 偏 移 Y 偏 移 大 小 : 向 左 偏 移 100 





图 6-5 无 偏 移 的 情况 图 6-6 向 左 偏 移 100 


Custom Custom 





偏 移 大 小 : 向 右 偏 移 100 x 偏 移 大 小 : 向 上 偏 移 100 





图 6-7 向 右 偏 移 100 图 6-8 向 上 偏 移 100 


2. onDraw 
onDraw 是 最 常 使 用 的 绘图 方法 , 该 方法 的 入 参 为 Canvas 画布 对 象 , 在 画布 上 绘图 相当 于 


在 屏幕 上 绘图 。 绘 图 本 身 是 个 很 大 的 课题 ， 画 布 的 用 法 也 多 种 多 样 ， 如 Canvas 提供 了 3 类 方 
法 ， 分 别 是 划 定 可 绘制 的 区 域 、 在 区 域内 部 绘制 图 形 和 画布 的 控制 操作 。 

















* 180 
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(1) 划 定 可 绘制 的 区 域 
虽然 本 视图 内 的 所 有 区 域 都 是 可 以 绘制 的 ， 但 是 有 时 候 我 们 只 想 在 某 个 矩形 区 域内 部 画 
， 这 时 在 绘图 之 前 就 得 指定 允许 绘图 的 区 域 界限 ， 相 关 方 法 说 明 如 下 : 


e clipPath: 裁剪 不 规则 曲线 区 域 。 

e clipRect: 裁剪 矩形 区 域 。 

e clipRegion: 3439 —J 8, 

(2) 在 区 域内 部 绘制 图 形 

该 类 方法 用 来 绘制 各 种 基本 几何 图 形 ， 相 关 方法 说 明 如 下 : 


drawArc: 绘制 扇形 / 弧 形 。 第 4 个 参数 为 true 时 画 扇形 、 为 false 时 画 弧 形 。 
drawBitmap: 绘制 图 像 。 

drawCircle: 绘制 圆 形 。 

drawLine: 绘制 直线 。 

drawOval: 绘制 椭圆 。 

drawPath: 绘制 路 径 ， 即 不 规则 曲线 。 

drawPoint: 绘制 点 。 

drawRect: 绘制 矩形 。 

drawRoundRect: $h) f 487b. 

drawText: 绘制 文本 。 


(3) 画布 的 控制 操作 
控制 操作 包括 旋转 、 缩 放 、 平 移 以 及 存 取 画 布 状 态 的 操作 ， 相 关 方法 说 明 如 下 : 
rotate: 旋转 画布 。 
scale: 缩放 画布 。 
translate: 平移 画布 。 
save: 保存 画布 状态 。 
restore: 恢复 画布 状态 。 
上 面 绘图 用 的 draw*** 方 法 只 是 指定 绘制 哪个 几何 图 形 ,真正 的 细节 描绘 还 要 靠 画笔 Paint 
类 实现 。Paint 类 定义 了 画笔 的 颜色 、 样 式 、 粗 细 、 阴 影 等 ， 常 用 方法 说 明 如 下 : 


setAntiAlias: 设置 是 否 使 用 抗 馈 齿 功 能 。 主 要 用 于 画 圆圈 等 曲线 。 
setDither: 设置 是 否 使 用 防 抖动 功能 。 

setColor: 设置 画笔 的 颜色 。 

setShadowLayer: ”设置 画笔 的 阴影 区 域 与 颜色 。 

setStyle: 设置 画笔 的 样式 。Style.STROKE 表示 线条 ，Style.FILL 表示 填充 。 
setStrokeWidth: 设置 画笔 线条 的 宽度 。 


下 面 演示 不 同 图 形 的 绘制 效果 。 调 用 drawRoundRect 方法 绘制 圆 角 和 矩 形 ， 如 图 6-9 所 示 。 
调用 drawOval 方法 绘制 椭圆 ， 如 图 6-10 所 示 。 


El 


ERE 
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图 6-9 绘制 圆 角 和 矩形 图 6-10 绘制 椭圆 
3. dispatchDraw 


dispatchDraw 与 onDraw 函数 一 样 都 是 绘图 方法 ， 区 别 在 于 onDraw 的 调用 在 绘制 子 视图 
之 前 ，dispatchDraw 的 调用 在 绘制 子 视图 之 后 。 如 果 不 想 自 身 视图 被 子 视图 覆盖 ， 就 只 能 在 
dispatchDraw 方法 中 进行 绘图 处 理 。 
下 面 演 示 如 何 通 过 dispatchDraw 方法 进行 绘图 : 
public class AfterRelativeLayout extends RelativeLayout { 
private int mDrawType = 0; 
private Paint mPaint = new Paint(); 


public AfterRelativeLayout(Context context) { 
this(context, null); 


} 


public AfterRelativeLayout(Context context,AttributeSet attrs) { 


super(context, attrs); 

mPaint.setAntiAlias(true); // 设 置 画 笔 为 无 锯齿 

mPaint.setDither(true); / 防 抖动 

mPaint.setColor(Color. BLACK); /设置 画笔 颜色 

mPaint.setStrokeWidth(3); // 线 宽 

mPaint.setStyle(Style.STROKE); // 画 笔 类 型 。 STROKE: 空心 ，FILL: 实心 
Ë 
(QOverride 
protected void dispatchDraw(Canvas canvas) í 

super.dispatchDraw(canvas); 


int width = getMeasuredWidth(); 

int height — getMeasuredHeight(); 

if (width>0 && height>0) í 
if(mDrawType — 1) í // 画 和 矩形 
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Rect rect = new Rect(0, 0, width, height); 
canvas.drawRect(rect, mPaint); 

} else if (mDrawType — 2) { // MAHEK 
RectF rectF = new RectF(0, 0, width, height); 
canvas.drawRoundRect(rectF, 30, 30, mPaint); 

} else if (mDrawType =3){ / 画 圆 圈 
int radius = Math.min(width, height)/2; 
canvas.drawCircle(width/2, height/2, radius, mPaint); 

} else if (mDrawType — 4) { // 画 椭圆 
RectF oval = new RectF(0, 0, width, height); 
canvas.drawOval(oval, mPaint); 

} else if (mDrawType — 5){ / 画 线段 
Rect rect = new Rect(0, 0, width, height); 
canvas.drawRect(rect, mPaint); 
canvas.drawLine(0, 0, width, height, mPaint); 
canvas.drawLine(0, height, width, 0, mPaint); 


} 


public void setDrawType(int type) í 
setBackgroundColor(Color. WHITE); 
mbDrawType = type; 
invalidate(); 


j 


观察 onDraw ^ dispatchDraw 两 种 绘图 方式 的 效果 对 比 , 如 图 6-11 和 图 6-12 所 示 。 其中， 
图 6-11 是 重 写 onDraw 方法 的 效果 图 ， 可 以 看 到 中 间 的 按钮 遮 住 了 交叉 线 ; 图 6-12 是 重 写 
dispatchDraw 方法 的 效果 图 ， 可 以 看 到 交叉 线 没 被 按钮 庶 住 ， 依 然 显示 在 视图 中 央 。 


[EC Custom 


preme 绘图 方式 : 








我 在 中 间 











图 6-11 重 写 onDraw 方法 图 6-12 重 写 dispatchDraw 方法 
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总 结 一 下 onLayout、onDraw、dispatchDraw 三 个 函数 的 区 别 : 


(1) onLayout 只 能 调整 子 视图 的 位 置 ， 而 onDraw 和 dispatchDraw 允许 绘制 新 图 形 。 

(2) onDraw 的 调用 在 绘制 子 视图 之 前 ， 而 dispatchDraw 的 调用 在 绘制 子 视图 之 后 。 

(3) onLayout 若 想 立 即 显示 位 置 调整 后 的 视图 ， 则 要 调用 requestLayout 方法 ; onDraw 
和 dispatchDraw 若 想 立 即 显 示 图 形 绘制 后 的 视图 ， 则 要 调用 invalidate 方法 。 


62 自 定 义 动画 


本 节 介绍 计时 器 的 实现 方式 和 如 何 利用 计时 器 实现 简单 的 下 拉动 画 ， 并 结合 自 定义 视图 
的 方法 实现 一 个 圆 弧 进度 动画 的 新 控件 。 


6.2.1 任务 Runnable 


在 前 面 的 章节 中 ， 有 几 个 需要 延迟 处 理 的 地 方 用 到 了 HandlertRunnable 组 合 ， 即 调用 
Handler 的 postDelayed 方法 延迟 若干 时 间 再 执行 指定 的 Runnable 任务 。 这 几 处 延迟 处 理 主要 
是 为 了 避免 资源 冲突 ， 不 过 延迟 处 理 更 多 用 于 动画 界面 的 演 染 。 

Runnable 接口 可 声明 一 连 串 任务 ， 定 义 了 接 下 来 要 做 的 事情 。 简 单 地 说 ，Runnable 接口 
就 是 一 个 代码 片段 。 实 现 Runnable 接口 只 需 重 写 run 函数 ， 在 该 方法 内 部 存放 要 运行 的 任务 
代码 。run 函数 无 须 显 式 调用 ， 在 启动 Runnable 实例 时 就 会 调用 对 象 的 run 方法 。 

尽管 基本 视图 View 提供 了 post 与 postDelayed 方法 用 于 启动 Runnable 任务 , 不 过 实际 开 
发 中 经 常 利 用 Handler 启动 任务 。 下 面 是 Handler 处 理 Runnable 任务 的 常见 方法 说 明 : 


post: 立即 启动 Runnable 任务 。 

postDelayed: 延迟 若干 时 间 后 启动 Runnable 任务 。 
postAtTime: 在 指定 时 间 启 动 Runnable 任务 。 
removeCallbacks: 移 除 指定 的 Runnable 任务 。 


计时 器 是 Runnable 的 一 个 简单 应 用 , 与 动画 的 实现 原理 相关 , 如 电影 每 秒 播放 20 帧 画面 ， 
连 起 来 就 是 会 动 的 视频 ， 动 画 的 泻 染 与 之 同 理 。 下 面 是 一 个 简单 计时 器 的 代码 片段 : 


@Override 
public void onClick(View v) { 
if (v.getId() = R.id.btn runnable) í 
if (bStart = false) { 
btn_runnable.setText(" 停 止 计数 "); 
mHandler.post(mCounter); 
J else { 
btn_runnable.setText(" 开 始 计数 "); 
mHandler.removeCallbacks(mCounter); 


e e. °. 


; 
bStart — !bStart; 


- 184 。 
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Ë 


private boolean bStart = false; 
private Handler mHandler = new Handler(); 
private int mCount = 0; 
private Runnable mCounter = new Runnable() í 
(@Override 
public void run() í 
mCount++; 
tv_resultsetText(" 当 前 计数 值 为 : "+mCount); 
mHandler.postDelayed(this, 1000); 


E 
计时 器 的 效果 如 图 6-13 和 6-14 所 示 。 其 中 ， 图 6-13 表示 当前 正在 计数 ， 图 6-14 表示 当 
前 停止 计数 ， 终 止 的 计数 值 为 21。 


Custom Custom 


停止 计数 
当前 计数 值 为 : 5 


图 6-13 计时 器 开始 计数 图 6-14 计时 器 结束 计数 
6.2.2 下拉 刷 新 动画 


现在 我 们 把 计时 器 引入 下 拉 刷 新 中 ， 每 隔 若 干 时 间 展 示 逐 步 加 大 的 视图 偏 移 ， 从 而 实现 
下 拉 刷 新 头 部 的 下 拉动 画 。 首 先 ， 计 算 下 拉 刷 新 头 部 的 高 度 ， 这 会 用 到 6.1 节 布 局 尺寸 测量 的 
知识 。 接 着 ， 计 时 器 每 隔 若 干 时 间 为 padding 设置 逐步 加 大 的 高 度 偏 移 。 不 得 不 说 ，padding 
大 法 非常 好 用 ， 当 padding 为 负 值 时 ， 表 示 当 前 视图 被 庶 住 了 一 部 分 。 最 后 ， 高 度 的 偏 移 值 达 
到 头 部 布局 的 高 度 时 ， 停 止 Runnable 的 刷新 任务 ， 下 拉动 画 完成 。 

下 面 是 下 拉 刷 新 动画 的 代码 片段 : 


@Override 
public void onClick(View v) { 
mHeight = (int) MeasureUtil.getRealHeight(ll header); 
if (v.getld() == R.id.btn pull) í 
if (bStart = false) í 
mOffset = -mHeight; 
btn pull.setEnabled(false); 
mHandler.post(mRefresh); 
j else { 
btn_pull.setText(" 开 始 刷新 "); 


开始 计数 


当前 计数 值 为 : 21 








Android Studio Tr $: 3928: 从 零 基础 到 App 上 线 





ll header.setVisibility( View. GONE); 


J 
bStart = !bStart; 
J 
} 
private int mHeight; 


private boolean bStart — false; 
private Handler mHandler = new Handler); 
private int mOffset — 0; 
private Runnable mRefresh = new Runnable() í 
@Override 
public void run() { 
if (mOffset <= 0) { 
ll header.setPadding(0, mOffset, 0, 0); 
1l header.setVisibility( View. VISIBLE); 
mOffset += 8; 
mHandler.postDelayed(this, 80); 
} else ( 
btn. pull.setText("I $2 Ji ifi"); 
btn pull.setEnabled(true); 


h 
下 拉 刷 新 动画 的 效果 如 图 6-15 和 6-16 所 示 。 其 中 ， 图 6-15 展示 的 是 下 拉动 画 进行 中 的 
RE: B 6-16 展示 的 是 下 拉 完 毕 的 截图 ， 此 时 下 拉 刷 新 头 部 完全 显示 。 
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恢复 页 面 
图 6-15 下 拉动 画 开始 图 6-16 下 拉动 画 结束 


6.2.3” 圆 缴 进 度 动画 


当 用 户 下 载 文件 或 做 其 他 事情 时 ， 往 往 想 知道 当前 到 什么 进度 了 。 在 Windows 系统 中 常 
昌 细 长 的 进度 条 表示 ,在 手机 上 因为 屏幕 限制 ,习惯 展示 圆 形 或 弧 形 的 进度 圈 。 接 下 来 介绍 的 
就 是 圆 弧 进度 动画 ， 该 动画 控件 正好 可 以 与 6.1 节 自 定义 视图 的 绘制 方法 结合 起 来 。 既 可 以 复 
习 旧 知识 ， 又 能 巩固 新 知识 。 
绘制 圆 弧 动画 的 主要 思路 是 在 一 段 指定 的 时 间 内 持续 不 断 地 绘制 一 个 扇形 或 圆 弧 ， 连 起 
来 整个 画面 就 会 动 起 来 。 还 要 进行 一 些 参数 设置 ， 如 设置 该 圆圈 的 位 置 、 开 始 和 结束 的 角度 、 
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转动 的 速率 ， 以 及 画笔 的 颜色 、 粗 细 、 样 式 等 。 另 外 ， 为 了 区 分 处 理 动画 的 背景 和 前 景 ， 还 要 
分 别 构造 背景 视图 (用 于 衬托 动画 〉 和 前 景 视图 (用 于 展示 圆 弧 〉。 
自 定义 圆 弧 动画 的 完整 代码 如 下 : 








public class CircleAnimation extends RelativeLayout { 
private final static String TAG = "CicleAnimation"; 
private RectF mRect = new RectF(100, 10, 400, 310); 
private int mBeginAngle = 0, mEndAngle = 270; 
private int mFrontColor = Oxffff0000, mShadeColor = Oxffeeeeee; 
private float mFrontLine = 10, mShadeLine = 10; 
private Style mFrontStyle = Style.STROKE, mShadeStyle = Style.SSTROKE; 
private ShadeView mShadeView; 
private FrontView mFrontView; 
private int mRate = 2. mDrawTimes = 0, mInterval = 70, mFactor, mSeq = 0, mDrawingAngle = 0; 
private Context mContext; 


public CircleAnimation(Context context) í 


super(context); 


mContext = context; 


public void render() í 
removeAllIViews(); 
mShadeView = new ShadeView(mContext); 
addView(mShadeView); 
mFrontView — new FrontView(mContext); 
addView(mFrontView); 
play(); 

j 


public void play() í 
mSeq = 0; 
mDrawingAngle = 0; 
mDrawTimes = mEndAngle/mRate; 
mFactor = mDrawTimes/mlnterval + 1; 
Log.d(TAG, "mDrawTimes="+mDrawTimes+",mInterval="+mInterval+",mFactor="+mFactor); 
mFrontView.invalidate View(); 


j 


public void setRect(int left, int top, int right, int bottom) í 
mRect = new RectF(left, top, right, bottom); 

} 

public void setAngle(int begin angle, int end angle) í 
mBeginAngle — begin angle; 
mEndAngle = end angle; 
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j 


/speed: 每 次 移动 几 个 度数 ”frames: 每 秒 移动 几 帧 
public void setmRate(int speed, int frames) í 

mRate = speed; 

mlnterval = 1000/frames; 
} 


public void setFront(int color, float line, Style style) { 
mFrontColor = color; 
mFrontLine = line; 
mFrontStyle = style; 

i 


public void setShade(int color, float line, Style style) { 
mShadeColor = color; 
mShadeLine = line; 
mShadeStyle = style; 


private class Shade View extends View í 
private Paint paint; 
public Shade View(Context context) í 
super(context); 
paint — new Paint(); 
paint.setAntiAlias(true); 


paint.setDither(true); 
paint.setColor(mShadeColor); 
paint.setStrokeWidth(mShadeLine); 
paint.setStyle(mShadeStyle); 
5 
@Override 
protected void onDraw(Canvas canvas) { 
super.onDraw(canvas); 
canvas.drawArc(mRect, mBeginAngle, 360, false, paint); 
j 


j 


private class FrontView extends View í 
private Paint paint; 
private Handler handler = new Handler); 
public FrontView(Context context) f 
super(context); 
paint = new Paint(); 


paint.setAntiA lias(true); /设置 画笔 为 无 锯齿 
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paint.setDither(true); // 防 拌 动 

paint.setColor(mFrontColor); // 设 置 画笔 颜色 

paint.setStroke Width(mFrontLine); IRR 

paint.setStyle(mFrontStyle); /画笔 类 型 。STROKE: “i, FILL: 实心 


//paint.setStrokeJoin(Paint.Join.ROUND); /画笔 接洽 点 类 型 。 影 响 矩 形 直角 的 外 轮廓 
paintsetStrokeCap(PaintCap.ROUND); /画笔 笔 刷 类 型 。 影 响 画笔 的 始末 端 
@Override 
protected void onDraw(Canvas canvas) { 
super.onDraw(canvas); 
canvas.drawArc(mRect, mBeginAngle, (float) (mDrawingAngle), false, paint); 
; 


public void invalidateView() f 
handler.postDelayed(drawRunnable, 0); 


J 
private Runnable drawRunnable = new Runnable() í 
@Override 
public void run() { 
if (mDrawingAngle >= mEndAngle) { 
mDrawingAngle = mEndAngle; 
invalidate(); 
handler.removeCallbacks(drawRunnable); 
} else { 
mDrawingAngle = mSeq*mRate; 
mSeq++; 
handler.postDelayed(drawRunnable, (long) (mlnterval-mSeq/mFactor)); 
invalidate(); 
; 
j 
h 


要 在 活动 页 面 中 显示 圆 弧 动画 ， 可 加 入 以 下 代码 : 

mAnimation = new CircleAnimation(this); 

Il layout.add View(mAnimation); 

maAnimation.render(); 
AISMA RUE 6-17 和 6-18 所 示 。 其 中 ， 图 6-17 展示 的 是 圆 弧 动画 进行 中 的 截图 ， 
图 6-18 展示 的 圆 弧 动画 播放 完成 的 截图 。 
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HERDADE 播放 贺 弧 动画 
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图 6-17 ” 圆 弧 动画 开始 图 6-18 圆 弧 动画 结束 


63 自 定 义 对 话 框 


本 节 介绍 窗口 与 对 话 框 的 基本 概念 和 使 用 方法 ， 并 利用 基础 对 话 框 实现 一 个 改进 的 日 期 
选择 对 话 框 ， 结 合 第 5 章 的 列表 视图 与 网 格 视图 给 出 阶段 性 实战 小 项 目 一 一 多 级 对 话 框 的 实 


现 效 果 。 


6.3.1 


对 话 框 Dialog 


App 界面 附着 在 窗口 Window 上 。 大 至 整个 活动 页 面 ， 小 至 Toast 的 提示 窗 ， 还 有 对 话 框 
Dialog， 都 建立 在 窗口 上 。 如 果 想 熟练 掌握 对 话 框 ， 就 必须 先 了 解 窗口 。 读 者 也 许 对 窗口 的 概 
念 不 甚 理解， 下 面 从 Window 的 5 个 常用 方法 开始 介绍 。 


setContentView: 设置 内 容 视图 。 这 个 方法 是 不 是 很 熟悉 ?我 们 每 天 打交道 的 Activity 第 
一 名 就 是 setContentView， 查 看 源码 后 发 现 内 部 原来 调用 了 同名 方法 getWindow(). 
setContentView. 

setLayout: 设置 内 容 视 图 的 宽 、 高 尺寸 。 

setGravity: 设置 内 容 视 图 的 对 齐 方式 。 

setBackgroundDrawable: 设置 内 容 视 图 的 背景 。 

findViewById: 根据 资源 ID 获取 该 视图 的 对 象 。 这 个 方法 每 个 Activity 代码 都 要 用 许多 
遍 。 查 看 Activity 源码 后 可 以 发 现 该 方法 也 是 调用 Window 的 同名 方法 getWindow(). 
findViewByld. 


原来 , 窗口 默默 地 做 了 许多 事情 , 只 是 我 们 不 知道 器 了 。 熟悉 了 Window 的 概念 和 用 法 后 ， 
再 来 看 看 Dialog 的 工作 机 制 ， 在 屏幕 上 显示 对 话 框 主要 有 3 个 步骤 : 

ED 构造 一 个 对 话 框 对 象 并 指定 该 对 话 框 的 样式 。 

CXX02 获取 该 对 话 框 依赖 的 窗口 对 象 ， 设 置 内 容 视图 并 指定 窗口 的 尺寸。 

CL 完成 相关 属性 设置 ， 显 示 对 话 框 。 
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下 面 来 看 具体 的 对 话 框 操作 方法 。 
e Dialog 构造 函数 : 可 定义 对 话 框 的 主题 样式 (样式 在 styles.xml 中 定义 ), 如 是 否 有 标题 、 
是 否 为 半 透 明 、 对 话 框 的 背景 是 什么 等 。 

e getWindow: 获取 对 话 框 的 窗口 对 象 。 该 方法 是 自 定义 对 话 框 的 关键 ， 首 先 获取 对 话 框 
所 在 的 窗口 对 象 ， 然 后 往 这 个 窗口 添加 定制 视图 。 
show: 显示 对 话 框 。 
isShowing: 判断 对 话 框 是 否 显示 。 
hide: 隐藏 对 话 框 。 
dismiss: 关闭 对 话 框 。 
setCancelable: 设置 对 话 框 是 否 可 取消 。 
setCanceledOnTouchOutside: 点 击 对 话 框 外 部 区 域 是 否 自动 关闭 对 话 框 。 默 认 会 自动 关 
Bl. 

e setOnShowListener: 设置 对 话 框 的 显示 监听 器 。 需 实现 OnShowListener 接口 的 onShow 

方法 。 
e setOnDismissListener: 设置 对 话 框 的 消失 监听 器 。 需 实现 OnDismissListener 接口 的 
onDismiss 方法 。 

6.3.2 ”改进 的 日 期 对 话 框 

对 话 框 常用 的 一 个 控件 是 AlertDialog ， 还 有 第 5 章 介绍 的 DatePickerDialog 和 
TimePickerDialog。 不 过 系统 自 带 的 对 话 框 往往 只 能 修改 文字 ， 无 法 调整 界面 布局 ， 也 无 法 定 
制 按钮 样式 , 甚至 连 文本 的 大 小 和 颜色 都 无 法 修改 。 以 日 期 选择 对 话 框 DatePickerDialog 为 例 ， 
该 对 话 框 的 标题 格式 为 “yyyy-mm-dd 周 几 ”， 按 钮 文字 为 “完成 ”， 如 图 6-19 所 示 。 





2016-10-6 周 
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图 6-19 系统 自 带 的 日 期 对 话 框 图 6-20 ”改进 后 的 日 期 对 话 框 


这 个 对 话 框 的 标题 文字 无 法 修改 ， 确 定 按钮 的 文字 也 无 法 修改 。 现 在 我 们 将 这 个 日 期 对 
话 框 改头换面 一 下 ， 使 之 更 符合 用 户 习 惯 ， 改 造 后 的 对 话 框 效果 如 图 6-20 所 示 。 其 中 ， 对 话 
框 标 题 改 为 “请 选择 日 期 ”， 确 定 按钮 的 文字 也 改 为 “确定 ”。 具 体 的 改造 过 程 分 3 步 : 


ETE 
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ED 定义 一 个 对 话 框 布局 文件 ， 在 合适 的 地 方 放置 标题 文字 的 TextView 控件 、 选 择 日 期 的 
DatePicker 控件 、 确 定 按钮 的 Button 控件 等 。 详 细 的 布局 文件 代码 如 下 : 








<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:background="(@color/transparent" 
android:gravity="center" 
android:orientation="vertical" 
android:paddingLeft-"40dp" 
android:paddingRight-"40dp" > 


*LinearLayout 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:orientation-" vertical" 
android:background-"(g;color/white" > 


«TextView 
android:id-"(g)*id/tv title" 
android:layout width-"match parent" 
android:layout height-"60dp" 
android:paddingLeft-" 10dp" 
android:gravity-"left|center" 
android:text=" 请 选择 日 期 " 
android:textColor="(@color/blue" 
android:textSize-"22sp" /> 


<View 
android:layout width-"match parent" 
android:layout height-"2dp" 
android:background-" (g/color/blue" > 


«DatePicker 
android:id="@+id/dp_date" 
android:layout_width="match_parent" 
android:layout_height="wrap_content" 
android:calendarViewShown="false" 
android:gravity="center" 
android:spinnersShown="true" /> 


<View 


android:layout width="match parent" 
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android:layout height-" Idp" 
android:background-" (gcolor/blue" /> 


«Button 
android:id-" (g*id/btn ok" 
android:layout width-"match parent" 
android:layout height-"60dp" 
android:background-" @null" 
android:gravity-"center" 
android:text-" fi E" 
android:textColor-" (Gcolor/black" 
android:textSize-" 17sp" /> 
*/LinearLayout^ 
*/LinearLayout^ 


EI 编写 自 定义 日 期 对 话 框 的 代码 ， 设 置 对 话 框 的 布局 、 样 式 、 日 期 、 标 题 ， 并 处 理 确定 按 
钮 的 点 击 事件 、 日 期 选择 器 的 变更 事件 等 。 自 定义 对 话 框 的 完整 代码 如 下 : 











public class CustomDateDialog implements OnClickListener, OnDateChangedListener í 
private Dialog dialog; 
private View view; 
private TextView tv title; 
private DatePicker dp date; 


public CustomDateDialog(Context context) í 
view = LayoutInflater.from(context).inflate(R.layout.dialog date, null); 
dialog = new Dialog(context, R.style.CustomDateDialog); 
tv. title = (TextView) view.findViewById(R.id.tv title); 
dp date = (DatePicker) view.findViewByld(R.id.dp date); 
view.findViewById(R.id.btn ok).setOnClickListener(this); 


public void setTitle(String title) í 
tv title.setText(title); 


public void setDate(int year, int month, int day, OnDateSetListener listener) í 
dp date.init(year, month, day, this); 
mbDateSetListener = listener; 


public void show() í 
dialog.getWindow()setContentView(view); 
dialog.getWindow().setLayout(LayoutParams. MATCH PARENT, LayoutParams. WRAP. CONTENT); 
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dialog.show(); 


public void dismiss() { 
if (dialog != null && dialog.isShowing()) í 
dialog.dismiss(); 


public boolean isShowing() í 
if (dialog != null) { 
return dialog.isShowing(); 
) else í 
return false; 


(@Override 
public void onClick(View v) í 
dismiss(); 
if (mDateSetL istener != null) í 
dp date.clearFocus(); 
/这 里 给 系统 月 份 加 一 ， 调 用 时 就 不 必 每 次 都 加 一 了 
mDateSetListener.onDateSet(dp date.getYear(), 
dp date.getMonth()*1, dp date.getDayOfMonth()); 


(@Override 
public void onDateChanged(DatePicker view, int year, int monthOfYear, int dayOfMonth) í 
dp date.init(year, monthOfYear, dayOfMonth, this); 


private OnDateSetListener mDateSetListener; 
public interface OnDateSetListener í 
void onDateSet(int year, int monthOfYear, int dayOfMonth); 


J: 
EIO 在 Acitvity 页 面 中 使 用 自 定义 的 日 期 对 话 框 ， 调 用 代码 举例 如 下 : 
Calendar calendar = Calendar.getInstance(); 


CustomDateDialog dialog = new CustomDateDialog(this); 
dialog.setDate(calendar.get(Calendar. YEAR), calendar.get(Calendar. MONTH), 














Ej 
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calendar.get(Calendar.DAY OF MONTH), this); 
dialog.show(); 


6.3.3 自 定义 多 级 对 话 框 


在 实际 开发 中 ， 自 定义 对 话 框 往往 比较 复杂 ， 比 如 对 话 框 不 在 屏幕 中 央 而 在 屏幕 下 方 、 
对 话 框 在 消失 前 还 需 做 其 他 处 理 、 对 话 框 像 多 级 菜单 一 样 需 要 分 级 展示 等 。 

如 图 6-21 与 图 6-22 所 示 ， 选 择 对 话 框 分 两 级 显示 。 图 6-21 展示 的 是 好 友 列 表 ， 用 到 了 
列表 视图 ListView; 图 6-22 展示 的 是 好 友 关 系 ， 用 到 了 网 格 视图 GridView， 二 级 对 话 框 位 于 
一 级 对 话 框 之 上 。 




















本 人 #4 弟弟 

您 将 添加 以 下 号 码 为 好 友 妹妹 mu 表 弟 表姐 

手机 号 码 允许 访问 朋友 图 we #= kadad ka 姑父 

15960238696 © sir O stu Li] gu 阿姨 vx mx 
15805910591 @ sir O 禁止 其 他 15805910591 @ 允许 O mur 型 队 
18905710571 @ 允许 O 禁止 其 他 18905710571 (€ tit O 禁止 LIE 

确定 
621 第 一 级 对 话 框 图 6-22 第 二 级 对 话 框 
这 个 多 级 对 话 框 是 一 个 阶段 性 的 实战 小 项 目 ， 不 但 运用 了 自 定义 对 话 框 的 进 阶 实现 ， 而 


且 使 用 了 第 5 章 介绍 的 列表 视图 与 网 格 视图 ， 有 兴趣 的 读者 可 尝试 将 其 编码 实现 。 完整 的 多 级 
对 话 框 代码 参见 本 书 的 下 载 资源 。 


6.4” 自 定义 通知 栏 


本 节 介 绍 通 知 栏 的 用 法 和 如 何 自 定义 通知 栏 ， 包 括 通知 推送 Notification 的 设置 、 进 度 条 
ProcessBar 的 样式 定制 、 远 程 视图 RemoteViews 的 配置 方法 , 并 给 出 一 个 自 定义 通知 栏 的 具体 
例子 。 

6.4.1 通知 推送 Notification 

在 手机 屏幕 的 项 端 下 拉 会 弹出 通知 栏 ， 里 面 存放 的 是 App 即时 提醒 用 户 的 消息 ， 消 息 内 
容 由 Notification 产生 并 推送 。 每 条 消息 通知 基本 都 有 图 标 、 标 题 、 内 容 、 时 间 等 元 素 ， 参 数 
通过 Notification.Builder 构建 。 下 面 来 看 常用 的 参数 构建 方法 。 

e setWhen: 设置 推送 时 间 ， 格 式 为 “小 时 : 分 钟 ”。 推 送 时 间 在 通知 栏 右 方 显示 。 

e setShowWhen: 设置 是 否 显示 推送 时 间 。 
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setUsesChronometer: 设置 是 否 显示 计数 器 。 为 true 时 不 显示 推送 时 间 ， 动 态 显 示 从 通知 
被 推送 到 当前 的 时 间 间 隔 ， 以 “分 钟 : 秒 钟 ”格式 显示 。 

setSmalllcon: 设置 状态 栏 里 面 的 图 标 (小 图 标 ) 。 

setTicker: 设置 状态 栏 里 面 的 提示 文本 。 

setLargelcon: 设置 通知 栏 里 面 的 图 标 ( 大 图 标 ) 。 

setContentTitle: 设置 通知 栏 里 面 的 标题 文本 。 

setContentText: 设置 通知 栏 里 面 的 内 容 文本 。 

setSubText: 设置 通知 栏 里 面 的 附加 说 明文 本 ， 位 于 内 容 文本 下 方 。 若 调用 该 方法 ， 则 
setProgress 的 设置 失效 。 

setProgress: 设置 进度 条 与 当前 进度 。 进 度 条 位 于 标题 文本 与 内 容 文本 中 间 。 

setNumber: 设置 通知 栏 右 下方 的 数字 , 可 与 setProgress 联合 使 用 , 表示 当前 的 进度 数值 。 
setContentInfo: 设置 通知 栏 右 下 方 的 文本 。 若 调用 该 方法 ， 则 setNumber 的 设置 失效 。 
setContentIntent: 设置 内 容 的 延 认 意图 PendingIntent， 点 击 该 通知 时 触发 该 意图 。 通常 调 
用 PendingIntent 的 getActivity 方法 获得 延迟 意图 对 象 ，getActivity 表示 点 击 后 跳 转 到 该 
页 面 。 

setDeleteIntent: 设置 删除 的 延迟 意图 PendingIntent， 滑 掉 该 通知 时 触发 该 动作 。 
setAutoCancel: 设置 该 通知 是 否 自动 清除 。 若 为 true， 则 点 击 该 通知 后 ， 通 知 会 自动 消 
K; 若 为 false， 则 点 击 该 通知 后 ， 通 知 不 会 消失 。 

setContent: 设置 一 个 定制 的 通知 栏 视图 RemoteViews, 用 于 取代 Builder 的 默认 视图 模板 。 
build: 构建 方法 。 在 以 上 参数 都 设置 完毕 后 ， 调 用 该 方法 返回 Notification 对 象 。 





使 用 以 上 设置 方法 要 注意 4 点 : 


(1) setSmalllcon 方法 必须 调用 ， 和 否则 不 会 显示 通知 消息 。 
(2) setWhen 与 setUsesChronometer 同时 只 能 调用 其 中 一 个 ， 即 推送 时 间 与 计数 器 无 法 


同时 显示 ， 因 为 它们 都 位 于 通知 栏 右边 。 


(3) setSubText 与 setProgress 同时 只 能 调用 其 中 一 个 ， 因 为 附加 说 明 与 进度 条 都 位 于 标 


题 文 本 下 方 。 


(4) setNumber 与 setContentInfo 同时 只 能 调用 其 中 一 个 ， 因 为 计数 值 与 提示 都 位 于 通知 


栏 右 下 方 。 


使 用 Notification 只 能 生成 通知 内 容 ， 实 际 推送 动作 还 需 借 助 系统 的 通知 服务 实现 。 
NotificationManager 是 系统 通知 服务 的 管理 类 ， 有 以 下 3 个 常用 方法 。 


notify: 推送 指定 消息 到 通知 栏 。 
cancel: 取消 指定 消息 。 调 用 该 方法 后 ， 通 知 栏 中 的 指定 消息 将 消失 。 
cancelAll: 取消 所 有 消息 。 


下 面 是 发 送 简单 消息 的 代码 片段 : 


GRE 


private void sendSimpleNotify(String title, String message) í 
Intent clickIntent — new Intent(this, MainActivity.class); 
PendinglIntent contentIntent = PendinglIntent.getActivity(this, 
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R.string.app name, clickIntent, PendingIntent.FLAG UPDATE CURRENT); 
Notification.Builder builder = new Notification.Builder(this); 
builder.setContentIntent(contentIntent) 

.setAutoCancel(true).setSmallIcon(R.drawable.ic app) 

.setTicker(" 提 示 消 息 来 啦 ").setWhen(System.currentTimeMillis()) 

.setLargelcon(BitmapFactory.decodeResource(getResources(), R.drawable.ic app)) 

.setContentTitle(title).setContentText(message); 

Notification notify — builder.build(); 
NotificationManager notifyMgr — (NotificationManager) 
getSystemService(Context. NOTIFICATION SERVICE); 
notifyMgr.notify(R.string.app name, notify); 
j 


简单 消息 的 通知 栏 效果 如 图 6-23 所 示 ， 左 边 是 图 标 ， 中 间 是 标题 与 内 容 ， 右 边 是 时 间 。 





图 6-23 简单 消息 的 通知 栏 效果 
下 面 是 发 送 计时 消息 的 代码 片段 : 


private void sendCounterNotify(String title, String message) í 


Intent cancellntent = new Intent(this, MainActivity.class); 
PendingIntent deleteIntent = PendinglIntent.getActivity(this, 

R.string.app name, cancelIntent, PendingInten.FLAG UPDATE CURRENT); 
Notification.Builder builder = new Notification.Builder(this); 
builder.setDeleteIntent(deleteIntent) 

.setAutoCancel(true).setUsesChronometer(true) 

.setProgress(100, 60, false).setNumber(99) 

.setSmallIcon(R.drawable.ic app).setTicker("J& zril f ena") 

.setLargelcon(BitmapFactory.decodeResource(getResources(), R.drawable.ic app)) 

.setContentTitle(title).setContentText(message); 

Notification notify — builder.build(); 
NotificationManager notifyMgr — (NotificationManager) 
getSystemService(Context. NOTIFICATION SERVICE); 
notifyMgr.notify(R.string.app name, notify); 
j 


计时 消息 的 通知 栏 效果 如 图 6-24 所 示 ， 通 知 栏 左 边 是 图 标 ， 中 间 是 标题 文本 、 进 度 条 和 
内 容 文本 ， 右 边 是 计时 器 与 计数 值 。 








到 











624 计时 消息 的 通知 栏 效 果 
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64.2 ”进度 条 ProcessBar 


消息 通知 Notification 的 setProgress 方法 是 对 内 置 进度 条 进行 操作 ， 不 过 很 多 时 候 进度 条 
会 单独 使 用 ， 有 必要 了 解 一 下 ProcessBar 的 具体 用 法 。 
下 面 来 看 进度 条 的 常用 属性 。 


e style: 指定 进度 条 的 形状 样式 。?android:attr/progressBarStyleHorizontal 表示 水 平 形 
状 ，?android:attr/progressBarStyle 表示 圆圈 形状 。 

e max: 指定 进度 条 的 最 大 值 。 

e progress: 指定 进度 条 当前 进度 值 。 

e secondaryProgress: 指定 进度 条 当前 次 要 进度 值 。 比 如 播放 视频 ，progress 用 来 表示 当前 
播放 进度 ，secondaryProgress 用 来 表示 当前 缓冲 进度 。 

e progressDrawable: 指定 进度 条 的 进度 图 形 。 

进度 条 的 常用 方法 有 以 下 9 个 。 

setProgress: 设置 当前 进度 。 

getProgress: 获取 当前 进度 。 

setSecondaryProgress: 设置 次 要 进度 。 

getSecondaryProgress: 获取 次 要 进度 。 

setMax: 设置 进度 条 的 最 大 值 。 

getMax: 获取 进度 条 的 最 大 值 。 

incrementProgressBy: 设置 当前 进度 的 增 量 。 

incrementSecondaryProgressBy: 设置 次 要 进度 的 增 量 。 

setProgressDrawable: 设置 进度 条 的 进度 图 形 。 

使 用 进度 条 时 需要 注意 以 下 两 点 : 

(1) max. progress 的 相关 属性 和 方法 只 在 样式 为 progressBarStyleHorizontal 时 才 有 效 ， 
即 水 平 进度 条 可 动态 设置 进度 值 ; 如 果 样 式 为 progressBarStyle 圆圈 形状 ， 最 大 值 与 进度 值 的 
设置 就 会 失效 , 即 圆圈 形状 不 会 显示 当前 进度 , 只 会 光 自 旋转 。 想 实现 动态 显示 进度 的 进度 条 ， 
可 参考 6.2 节 的 圆 弧 进度 动画 。 

(2) progressDrawable 进度 图 形 不 能 用 普通 图 形 ， 只 能 用 层次 图 形 LayerDrawable。 层 次 
图 形 可 在 XML 文件 中 定义 ， 如 果 用 于 描述 进度 图 形 就 要 同时 定义 两 个 层次 ， 即 背景 层次 与 进 
度 条 层次 。 例如 ,在 自 定义 圆 弧 动画 时 运用 了 背景 视图 与 前 景 视图 ， 在 进度 条 中 就 存在 背景 层 
次 ， 只 不 过 前 景 视 图 换 成 了 进度 条 层次 。 


下 面 是 一 个 层次 图 形 定义 的 XML 例子 。 其 中 ， 根 节点 layer-list 表示 这 是 一 个 层次 列表 ， 
即 层次 图 形 定义 ， 背 景 层 次 的 id 为 @android:id/background， 采 用 的 是 形状 图 形 (节点 名 称 为 
shape) ; 进度 条 层次 的 id 为 @android:id/progress， 采 用 的 是 裁 前 图 形 ClipDrawable (节点 名 
TION clip) : 





WB 
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<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
<item android:id="(@android:id/backeround"> 


<shape> 
«solid android:color="#333333" /> 
</shape> 
</item> 
<item android:id="(@android:id/progress"> 
<clip> 
<nine-patch android:src="(@drawable/notify_green" /> 
</clip> 
</item> 
</layer-list> 
下 面 是 进度 条 控件 在 布局 文件 中 使 用 的 XML 代码 : 
<ProgressBar 


android:id="@+id/pb_progress" 
style="?android:attr/progressBarStyleHorizontal" 
android:layout_width="match_parent" 
android:layout_height="30dp" 
android:background="@color/black" 

android:max="100" 

android:progress="0" 
android:progressDrawable="(@drawable/notify_progress_green" /> 


进度 条 设置 前 后 的 效果 如 图 6-25 与 图 6-26 所 示 。 其 中 ， 图 6-25 所 示 为 进度 值 为 0 的 界 
面 ， 此 时 只 有 一 条 黑色 的 进度 条 背景 ; 图 6-26 所 示 为 进度 值 为 40 的 界面 ， 此 时 绿色 进度 条 占 
据 全 部 进度 长 度 的 40%。 


40 


wawas 
情 输 入 两 位 进度 值 
显示 进度 条 显示 进度 条 
图 6-25 进度 值 为 0 的 进度 条 "Im; 


6.4.3 ”远程 视图 RemoteViews 


前 面 介绍 Notification 的 常用 方法 时 提 到 setContent. 方法 可 以 在 设置 定制 的 通知 栏 视图 
RemoteViews 时 取代 Builder 的 默认 视图 模板 。 这 表示 通知 栏 允许 自 定义 ， 并 且 自 定义 通知 栏 
需要 采用 远程 视图 RemoteViews。 

与 活动 页 面相 比 ， 如 果 说 对 话 框 是 一 个 小 型 页 面 ， 远 程 视图 就 是 一 个 小 型 且 简 化 的 页 面 。 
简化 的 意思 是 功能 减少 了 ,限制 变 多 了 。 虽 然 RemoteViews 5 Activity 一 样 有 自己 的 布局 文件 ， 
但 是 RemoteViews 的 使 用 权限 小 了 很 多 。 两 者 的 区 别 主要 有 : 
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(1) RemoteViews 主要 用 于 通知 栏 部 件 和 桌面 部 件 ， 而 Activity 用 于 页 面 。 

(2) RemoteViews 只 支持 少数 几 种 控件 , 如 TextView、ImageView、Button、ImageButton、 
ProcessBar、Chronometer( 计 时 器 ) 和 AnalogClock〔 模 拟 时 钟 〉。 

(3) RemoteViews 不 可 直接 获取 和 设置 控件 信息 ， 只 能 通过 该 对 象 的 set 方法 修改 控件 
信息 。 


下 面 来 看 远程 视图 的 常用 方法 。 


构造 函数 : 创建 一 个 RemoteViews 对 象 。 第 一 个 参数 是 包 名 ,第 二 个 参数 是 布局 文件 id. 
setViewVisibility: 设置 指定 控件 是 否 可 见 。 

setViewPadding: 设置 指定 控件 的 间距 。 

setTextViewText: 设置 指定 TextView 或 Button 控件 的 文字 内 容 。 
setTextViewTextSize: 设置 指定 TextView 或 Button 控件 的 文字 大 小 。 

setTextColor: 设置 指定 TextView 或 Button 控件 的 文字 颜色 。 
setTextViewCompoundDrawables: 设置 指定 TextView 或 Button 控件 的 文字 周围 图 标 。 
setImageViewResource: 设置 ImageView 或 ImgaeButton 控件 的 资源 编号 。 
setImageViewBitmap: 设置 ImageView 或 ImgaeButton 控件 的 位 图 对 象 。 
setChronometer: 设置 计时 器 信息 。 

setProgressBar: 设置 进度 条 信息 ， 包 括 最 大 值 与 当前 进度 。 

setOnClickPendingIntent: 设置 指定 控件 的 点 击 响应 动作 。 


完成 RemoteViews 对 象 的 构建 与 设置 后 调用 Notification 对 象 的 setContent 方法 ， 即 可 完 
成 自 定义 通知 的 定义 。 
下 面 是 一 个 远程 视图 用 到 的 布局 文件 代码 : 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match_parent" 
android:layout height="match parent" 
android:minHeight-"64dp" 
android:orientation-"horizontal" > 


<ImageView 
android:layout_width="0dp" 
android:layout height-"match parent" 
android:layout weight-"1" 
android:scaleType-" fitCenter" 
android:src-"(g)drawable/tt" /> 


*LinearLayout 
android:layout width-"Odp" 
android:layout height-"match parent" 
android:layout marginLeft-"5dp" 
android:layout marginRight-"5dp" 
android:layout weight-"5" 








android:orientation="vertical" > 


<ProgressBar 
android:id="@+id/pb play" 
style="?android:attr/progressBarStyleHorizontal" 
android:layout width="match parent" 
android:layout height-"Odp" 
android:layout weight-"1" 
android:max-" 100" 
android:progress-" 10" /> 


«TextView 
android:id-"(Q)*id/tv play" 
android:layout width-"match parent" 
android:layout height-"Odp" 
android:layout weight-"1" 
android:textColor-"4fffrfP" 
android:textSize-" 17sp" /> 
«/LinearLayout^ 


*LinearLayout 
android:layout width-"Odp" 
android:layout height-"match parent" 
android:layout weight-"1" 
android:orientation-" vertical" > 


*Chronometer 
android:id-"(g)id/chr play" 
android:layout width-"match parent" 
android:layout height-"Odp" 
android:layout weight-"1" /> 


«Button 
android:id-"(g)*id/btn play" 
android:layout width-"match parent" 
android:layout height-"Odp" 
android:layout weight-"2" 
android:text-" fj £z" 
android:textColor—"4ZfffrfP" 
android:textSize-" 17sp" /> 
«/LinearLayout^ 
«/LinearLayout^ 


下 面 是 自 定义 通知 栏 的 调用 代码 : 


private void sendCustomNotify(Context ctx, String event, String song, boolean isPlay, int progress, long 
time) í 
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Intent plntent = new Intent(event); 
PendingIntent nIntent = PendingIntent.getBroadcast( 

ctx, R.string.app name, pIntent, PendingIntent.FLAG UPDATE CURRENT); 
RemoteViews notify music — new RemoteViews(ctx.getPackageName(), R.layout.notify music); 
if (isPlay — true) í 

notify music.setTextViewText(R.id.btn play, "暂停 "); 
notify music.setTextViewText(R.id.tv play, song+" 正 在 播放 "); 
notify music.setChronometer(R.id.chr play, time, "%s", true); 
} else { 
notify music.setTextViewText(R.id.btn play, "继续 "); 
notify music.setTextViewText(R.id.tv play, song+" 暂 停 播 放 "); 
notify music.setChronometer(R.id.chr play, time, "%s", false); 
J 
notify music.setProgressBar(R.id.pb play, 100, progress, false); 
notify music.setOnClickPendingIntent(R.id.btn play, nIntent); 
Intent intent = new Intent(ctx, MainActivity.class); 
PendingIntent contentIntent = PendingIntent.getActivity(ctx, 

R.string.app name, intent, PendingIntent.FLAG UPDATE CURRENT); 
Notification.Builder builder = new Notification.Builder(ctx); 
builder.setContentIntent(contentIntent) 

.setContent(notify music).setTicker(song).setSmallIcon(R.drawable.tt s); 
Notification notify — builder.build(); 

NotificationManager notifyMgr — (NotificationManager) getSystemService 
(Context.NOTIFICATION SERVICE); 
notifyMgr.notify(R.string.app name, notify); 
j 


自 定义 通知 栏 的 效果 如 图 6-27 所 示 , 可 以 看 到 播放 器 图 标 在 通知 栏 左边 , 进度 条 在 上 方 ， 
歌曲 名 称 在 下 方 ， 计 时 器 与 控制 按钮 分 布 在 通知 栏 右 边 。 


T? 北京 欢迎 你 正在 播放 


E627 自 定义 通知 栏 的 效果 图 





6.5 Service 基础 


本 节 介绍 为 何 使 用 服务 Service 和 如 何 使 用 服务 ， 包 括 服务 的 生命 周期 和 在 3 种 启 停 方式 
下 的 生命 周期 过 程 ， 有 普通 启 停 、 立 即 绑 定 和 延迟 绑 定 。 另 外 ， 介 绍 怎样 结合 通知 推送 
Notification 实现 把 服务 推送 到 前 台 的 功能 。 
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6.5.1 Service 的 生命 周期 


服务 Service 是 Android 的 四 大 组 件 之 一 ， 常 用 在 看 不 见 页 面 的 高 级 场合 ， 如 第 5 章 定时 
器 用 到 了 系统 的 闹钟 服务 ，6.4 节 通 知 推送 用 到 了 系统 的 通知 服务 。 既 然 Android 有 系统 服务 ， 
App 也 可 以 有 自己 的 服务 。Service 与 Activity 相 比 , 不 同 之 处 在 于 没有 对 应 的 页 面 ， 相同 之 处 
在 于 有 生命 周期 。 要 想 用 好 服务 ， 就 要 探究 其 生命 周期 。 

下 面 是 Service 与 生命 周期 有 关 的 方法 说 明 。 


e onCreate: 创建 服务 。 
e onStar: 开始 服务 ，Android2.0 以 下 版 本 使 用 ， 现 已 废弃 。 
e onStartCommand: 开始 服务 , Android2.0 及 以 上 版 本 使 用 。 该 函数 的 返回 值 说 明 见 表 6-5. 


表 6-5 服务 启动 的 返回 值 说 明 

返回 值 类 型 返回 值 说 明 

START STICKY 粘性 的 服务 。 如 果 服 务 进程 被 杀 掉 ， 就 保留 服务 的 状态 为 开始 状态 , 但 
不 保留 传送 的 Intent 对 象 。 随 后 系统 尝试 重新 创建 服务 ， 由 于 服务 状态 
为 开始 状态 ， 因 此 创建 服务 后 一 定 会 调用 onStartCommand 方法 。 如 果 
在 此 期 间 没有 任何 启动 命令 传送 给 服务 ， 参 数 Intent RA 

START NOT STICKY 非 粘 性 的 服务 。 使 用 这 个 返回 值 时 ， 如 果 服 务 被 异常 杀 掉 ， 系 统 就 不 会 
自动 重启 该 服务 
START REDELIVER INTENT 重 传 mtent 的 服务 。 使 用 这 个 返回 值 时 ， 如 果 服 务 被 异常 杀 掉 ， 系 统 就 
会 自动 重启 该 服务 ， 并 传 入 Intent 的 原 值 
START STICKY COMPATIBILITY | START STICKY 的 兼容 版 本 ， 不 保证 服务 被 杀 掉 后 一 定 能 重启 


onDestroy: 销毁 服务 。 

onBind: 绑 定 服务 。 

onRebind: 重新 绑 定 。 该 方法 只 有 当 上 次 onUnbind 返回 true 的 时 候 才 会 被 调用 。 
onUnbind: 解除 绑 定 。 返 回 值 为 true 表示 允许 再 次 绑 定 ， 再 绑 定时 调用 onRebind 方法 ; 
返回 值 为 false 表示 只 能 绑 定 一 次 ， 不 能 再 次 绑 定 ， 默 认为 false, 


看 来 Service 的 生命 周期 也 不 简单 ， 分 好 几 种 生命 周期 方法 。 原 因 是 服务 存在 多 种 启 停 方 
式 ， 如 普通 启 停 、 立 即 绑 定 、 延 迟 绑 定 ， 每 种 启 停 方式 都 对 应 不 同 的 周期 方法 。 下 面 分 别 叙述 
3 种 启 停 方式 及 其 生命 周期 说 明 。 

1. 普通 启 停 

普通 启 停 是 最 简单 的 用 法 。 下 面 是 该 方式 的 服务 代码 : 


public class SimpleService extends Service { 
private static final String TAG = "SimpleService"; 











@Override 
public int onStartCommand(Intent intent, int flags, int startid) í 
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Log.d(TAG, "测试 服务 到 此 一 游 ! "); 
return START. STICKY; 
} 


(@Override 
public IBinder onBind(Intent intent) í 
return null; 
} 
} 
这 个 服务 很 简单 ， 功 能 只 是 打印 一 行 日 志 “ 测 试 服务 到 此 一 游 ! ”。 在 Acitivity 代码 中 ， 
启 停 服务 也 很 简单 ， 调 用 startService 方法 即 可 启动 服务 , 调用 stopService 方法 即 可 停止 服务 。 
当然 ， 也 可 以 在 Intent 对 象 中 传递 参数 信息 。 示 例 的 调用 代码 如 下 : 
Intent intent = new Intent(this, SimpleService.class); 
startService(intent); 
普通 启 停 方式 的 服务 生命 周期 可 通过 打印 日 志 观 察 ， 也 可 在 页 面 上 直接 显示 日 志 。 启 动 
服务 依次 调用 了 onCreate 与 onStartCommand 方法 ,如 图 6-28 所 示 。 停 止 服务 调用 了 onDestroy 
方法 ， 如 图 6-29 所 示 。 


Custom Custom 


启动 服务 停止 服务 启动 服务 停止 服务 


21:07:14 onCreate 
21:07:14 onStartCommand. flags=0 


21:07:14 onCreate 
21:07:14 onStartCommand. flags-0 
21:07:56 onDestroy 





图 6-28 ”启动 服务 的 日 志 图 6-29 停止 服务 的 日 志 


2. 立即 绑 定 
绑 定 方式 的 服务 定义 有 所 不 同 ， 因 为 绑 定 的 服务 可 能 运行 于 另 一 个 进程 ， 所 以 必须 定义 
-个 Binder 对 象 用 来 进行 进程 间 的 通信 。 下 面 是 一 个 绑 定 方式 的 服务 代码 : 
public class BindImmediateService extends Service í 
private static final String TAG = "BindImmediateService"; 
private final IBinder mBinder — new LocalBinder(); 
public class LocalBinder extends Binder í 
public BindImmediateService getService() í 
return BindImmediateService.this; 
; 
; 


@Override 
public IBinder onBind(Intent intent) { 
Log.d(TAG " 绑 定 服务 开始 旅程 ! "); 
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return mBinder; 


(@Override 

public boolean onUnbind(Intent intent) í 
Log.d(TAG, " 绑 定 服务 结束 旅程 ! "); 
return false; 


j 


这 个 服务 在 绑 定时 会 打印 日 志 “ 绑 定 服务 开始 旅程 ! "o. TEMWDRDUDEIN TEE s “H 
定 服务 结束 旅程 ! ”。 在 Activity 中 ， 绑 定 / 解 绑 服 务 的 做 法 与 普通 方式 不 同 ， 首 先 要 定义 一 
个 ServiceConnection 的 服务 连接 对 象 ， 然 后 调用 bindService 方法 或 unbindService 方法 进行 绑 
定 或 解 绑 操作 ， 具 体 的 示例 代码 如 下 : 


public class BindImmediateActivity extends AppCompatActivity implements OnClickListener í 
private static TextView tv immediate; 
private Intent mIntent; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity bind immediate); 
tv immediate = (TextView) find ViewById(R.id.tv immediate); 
findViewById(R.id.btn start bind).setOnClickListener(this); 
findViewById(R.id.btn unbind).setOnClickListener(this ); 
mintent = new Intent(this, BindlmmediateService.class); 


@Override 
public void onClick(View v) { 
if (v.getId() = R.id.btn_start_bind) í 
boolean bindFlag = bindService(mIntent, mFirstConn, Context.BIND_AUTO_CREATE); 
} else if (v.getld() == R.id.btn_unbind) í 
if (mBindService != null) í 
unbindService(mFirstConn); 
mBindService = null; 


private BindImmediateService mBindService; 
private ServiceConnection mFirstConn = new ServiceConnection() í 


/获取 服务 对 象 时 的 操作 
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public void onServiceConnected(ComponentName name, IBinder service) í 
/如果 服 务 运行 于 另 一 个 进程 ， 就 不 能 直接 强制 转换 类 型 
// 否 则 会 报错 java.lang.ClassCastException: android.os.BinderProxy cannot be cast to... 
mBindService = ((BindImmediateService.LocalBinder) service).getService(); 


/无 法 获取 服务 对 象 时 的 操作 
public void onServiceDisconnected(ComponentName name) í 
mBindService = null; 


J 


j 


接 下 来 ， 继 续 观察 立即 绑 定 方式 的 生命 周期 ， 该 方式 的 服务 周期 日 志 如 图 6-30 和 图 6-31 
所 示 。 其 中 ， 图 6-30 所 示 为 立即 绑 定时 的 界面 ， 此 时 依次 调用 onCreate 和 onBind 方法 ; 图 
6-31 所 示 为 立即 解 绑 时 的 界面 ， 此 时 依次 调用 onUnbind 和 onDestroy 方法 。 


Custom Custom 


启动 并 绑 定 服务 解 绑 并 停止 服务 启动 并 绑 定 服务 解 绑 并 停止 服务 


21:10:07 onCreate 21:10:07 onCreate 

21:10:07 onBind 21:10:07 onBind 
21:10:36 onUnbind 
21:10:36 onDestroy 





图 6-30 立即 绑 定 的 日 志 图 6-31 立即 解 绑 的 日 志 
3. 延迟 绑 定 


延迟 绑 定 与 立即 绑 定 的 区 别 在 于 : 延迟 绑 定 是 在 页 面 上 先 通过 startService 方法 启动 服务 
然后 通过 bindService 方法 绑 定 已 存在 的 服务 。 这 样 一 来 ， 因 为 启动 操作 在 先 ， 所 以 解 绑 操作 
只 能 撤销 绑 定 操 作 ， 而 不 能 撤销 启动 操作 。 由 于 解 绑 服务 不 能 停止 服务 ， 因 此 存在 再 次 绑 定 服 
务 的 可 能 。 

下 面 观察 延迟 绑 定 的 上 日志， 验证 一 下 实际 结果 是 否 符合 我 们 的 猜想 。 依 次 查看 “启动 服 
务 一 绑 定 服务 一 解 绑 服务 ”的 运行 日 志 ， 如 图 6-32 所 示 ; 依次 查看 “ 绑 定 服务 一 解 绑 服 务 一 
停止 服务 ”的 运行 日 志 ， 如 图 6-33 所 示 。 

















启动 服务 MERS MRBS 。 停止 服务 启动 服务 MERS MARS — 停止 服务 


21:11:12 onCreate 21:11:12 onCreate 





21:11:12 onStart 21:11:12 onStart 
21:11:20 onBind 21:11:20 onBind 
21:11:53 onUnbind 21:11:53 onUnbind 


21:12:36 onRebind 
21:12:42 onUnbind 
21:12:42 onDestroy 

















图 6-32 ”延迟 绑 定 的 日 志 6-33 再 次 绑 定 的 日 志 
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从 日 志 中 可 以 看 到 ， 延 迟 绑 定 与 立即 绑 定 两 种 方式 的 生命 周期 区 别 在 于 : 


d) 延迟 绑 定 的 首次 绑 定 操作 只 调用 onBind 方法 ， 再 次 绑 定 只 调用 onRebind 方法 (是 
否 允 许 再 次 绑 定 要 看 上 次 onUnbind 方法 的 返回 值 ) 。 
(2) 延迟 绑 定 的 解 绑 操 作 只 调用 onUnbind 方法 。 


6.5.2 ”推送 服务 到 前 台 


服务 没有 自己 的 布局 文件 ， 也 就 意味 着 无 法 直接 在 页 面 上 展示 ， 要 想 了 解 服务 的 运行 情 
Di, 要 么 通过 打印 日 志 , 要 么 获取 某 个 页 面 的 静态 对 象 ， 然后 在 该 页 面 上 显示 运行 结果 。 然 而 
活动 页 面 有 自身 的 生命 周期 , 极 有 可 能 发 生 服 务 尚 在 运行 但 页 面 早已 退出 的 情况 , 所 以 该 方式 
不 可 靠 。 幸 好 , 服务 不 只 能 在 外 部 进行 启 停 或 绑 定 , 还 能 在 内 部 模拟 启 停 ,当然 仅 是 模拟 而 已 。 
服务 内 部 的 启 停 方法 也 有 对 应 的 两 个 函数 。 


e startForeground: 把 当前 服务 切换 到 前 台 运 行 。 第 一 个 参数 表示 通知 的 编号 ,第 二 个 参数 
表示 Notification 对 象 ， 意 味 着 切换 到 前 台 就 是 展示 到 通知 栏 。 
e stopForeground: 停止 前 台 运 行 。 参 数 为 true 表示 清除 通知 ， 参 数 为 false 表示 不 清除 。 


服务 在 前 台 运 行 的 一 个 常见 的 应 用 是 音乐 播放 器 ， 即 使 用 户 离开 了 播放 器 页 面 ， 手 机 仍 
然 能 在 后 台 继 续 播放 音乐 , 同时 还 能 在 通知 栏 查 看 播放 进度 ， 控 制 播放 与 暂停 操作 。 下 面 是 一 
个 音乐 播放 服务 的 例子 : 
(@TargetApi(Build.VERSION_CODES.JELLY_BEAN) 
public class MusicService extends Service í 
private final IBinder mBinder = new LocalBinder(); 
public class LocalBinder extends Binder í 
public MusicService getService() { 
return MusicService.this; 
b 
} 


@Override 

public IBinder onBind(Intent intent) í 
Log.d(TAG, "onBind"); 
return mBinder; 

} 


private String mSong; 

private String PAUSE EVENT = ""; 
private boolean bPlay — true; 

private long mBaseTime; 

private long mPauseTime — 0; 

private int mProcess — 0; 

private Handler mHandler — new Handler); 
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private Runnable mPlay = new Runnable() í 
@Override 
public void run() { 
if (bPlay = true) { 
mProcess = (mProcess < 100) ? mProcess+2 : 0; 
mHandler.postDelayed(this, 1000); 
j 
Notification notify = getNotify(MusicService.this, PAUSE EVENT, mSong, bPlay, 
mProcess, mBaseTime); 
startForeground(2, notify); 


h 


private Notification getNotify(Context ctx, String event, String song, boolean isPlay, int progress, long 
time) { 
Intent pIntent = new Intent(event); 
PendingIntent nIntent = PendingIntent.getBroadcast( 

ctx, R.string.app name, pIntent, PendingInten.FLAG UPDATE CURRENT); 
RemoteViews notify music = new RemoteViews(ctx.getPackageName(), R.layout.notify music); 
if (isPlay = true) í 

notify music.setTextViewText(R.id.btn play, "暂停 "); 
notify music.setTextViewText(R.id.tv play, song+" 正 在 播放 "); 
notify_music.setChronometer(R.id.chr_play, time, "%s", true); 
} else ( 
notify music.setTextViewText(R.id.btn play, "继续 "); 
notify music.setTextViewText(R.id.tv play, song+" 暂 停 播放 "); 
notify music.setChronometer(R.id.chr play, time, "%s", false); 
j 
notify music.setProgressBar(R.id.pb play, 100, progress, false); 
notify music.setOnClickPendingIntent(R.id.btn play, nIntent); 
Intent intent = new Intent(ctx, MainActivity.class); 
PendingIntent contentIntent = PendingIntent.getActivity(ctx, 

R.string.app name, intent, PendingIntent.FLAG UPDATE CURRENT); 
Notification.Builder builder = new Notification.Builder(ctx); 
builder.setContentIntent(contentIntent).setContent(notify music) 

.setTicker(song).setSmallIcon(R.drawable.tt s); 

Notification notify — builder.build(); 
return notify; 


@Override 
public int onStartCommand(Intent intent, int flags, int startid) í 
mBaseTime = SystemClock.elapsedRealtime(); 
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bPlay = intent.getBooleanExtra("is play", true); 
mSong = intent.getStringExtra("song"); 
mHandler.postDelayed(mPlay, 200); 

return START STICKY; 


@Override 

public void onCreate() { 
PAUSE_EVENT = getResources().getString(R.string.pause_event); 
pauseReceiver = new PauseReceiver(); 
IntentFilter filter = new IntentFilter(PAUSE EVENT); 
registerReceiver(pauseReceiver, filter); 
super.onCreate(); 

j 


(@Override 

public void onDestroy() í 
unregisterReceiver(pauseReceiver); 
super.onDestroy(); 

; 


private PauseReceiver pauseReceiver; 
public class PauseReceiver extends BroadcastReceiver í 
(@Override 
public void onReceive(Context context, Intent intent) í 
if (intent != null) í 
bPlay = !bPlay; 
if (bPlay — true) í 
mHandler.postDelayed(mPlay, 200); 
if (mPauseTime > 0) í 
long gap = SystemClock.elapsedRealtime() - mPauseTime; 
mBaseTime += gap; 





j 
) else í 
mPauseTime = SystemClock.elapsedRealtime(); 
j 
} 
j 
} 
; 
上 述 代 码 的 与 众 不 同 之 处 在 于 点 击 播放 /暂停 按钮 的 处 理 ， 此 时 触发 的 延迟 意图 对 象 由 





getBroadcast 方法 获得 ， 原 因 是 getActivity 获得 的 对 象 只 会 跳 转 到 某 个 页 面 ， 要 想 让 触发 的 事 
件 作 用 于 服务 内 部 ， 只 能 通过 广播 的 方式 。 
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音乐 播放 服务 的 前 台 运 行 效 果 如 图 6-34 和 图 6-35 所 示 。 其 中 ， 图 6-34 所 示 为 正在 播放 
的 通知 栏 界 面 ， 图 6-35 所 示 为 暂停 播放 的 通知 栏 界面 。 


T? 让 我 们 荡 起 双 桨 正在 播放 





图 6-34 ”正在 播放 的 通知 栏 界面 图 6-35 暂停 播放 的 通知 栏 界面 








6.6 KRMH: 手机 安全 助手 


本 节 将 设计 一 个 实战 项 目 一 一 手机 安全 助手 ， 该 项 目 采用 多 种 自 定义 控件 的 相关 技术 ， 
并 同时 运用 多 种 存储 技术 。 通 过 该 实战 项 目的 练习 能 够 加 深 自 定义 控件 的 用 法 理解 , 还 能 复习 
巩固 前 两 章 的 存储 技术 知识 。 


664 设计 思路 


如 同 电脑 上 的 杀毒 软件 , 手机 上 也 有 形形色色 的 安全 App, 比如 ** 安 全 管家 、** 安 全 卫士 、 
## 安 全 助手 等 ， 这 些 安全 App 都 有 一 个 核心 模块 流量 监控 功能 。 现 在 运营 商都 靠 流量 赚 
钱 ， 比 如 100M 流量 要 10 元 钱 、1G 流量 要 100 元 ， 很 多 App 一 打开 就 是 满 屏 图 片 ， 非 常 费 
流量 ， 而 且 有 的 App 会 偷 跑 流量 ， 很 多 用 户 不 知 不 觉 电话 费 就 被 流量 花 光 了 。 流 量 监控 功能 
很 实用 ， 基 础 实现 也 不 难 ， 下 面 就 以 流量 监控 为 例 ， 做 一 个 “手机 安全 助手 ”的 实战 项 目 ， 活 
学 活用 本 章 自 定义 控件 的 相关 知识 。 

先 来 看 手机 安全 助手 的 总 体 页 面 效 果 。 为 了 起 到 提醒 作用 ， 对 于 超出 限额 的 流量 部 分 使 
用 含有 警示 意义 的 橙色 显示 ， 如 图 6-36 所 示 。 如 果 当 天 已 用 流量 未 超出 限额 ， 就 使 用 绿色 显 
示 流 量 信息 ， 如 图 6-37 所 示 。 
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6-36 ”流量 限额 为 30M 的 流量 页 面 图 6-37 流量 限额 为 50M 的 流量 页 面 
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上 面 说 的 流量 限额 可 在 配置 页 面 进 行 设 置 ， 配 置 页 面 效 果 如 图 6-38 Pra o 


Custom 





每 月 限额 : 1024 


每 日 限额 : 30 





图 6-38 流量 限额 配置 页 面 
再 来 看 助手 App 的 通知 栏 效果 ， 超 出 限额 的 流量 同样 使 用 橙色 进度 条 展示 ， 如 图 6-39 所 
; 若 未 超出 当日 限额 ， 则 使 用 绿色 展示 进度 条 ， 如 图 6-40 所 示 。 
am 手机 安全 助手 实时 监控 中 手机 安全 助手 实时 监控 中 


dl 


ws | 今日 已 用 流量 34.3M kami 今日 已 用 流量 34.3M 





图 6-39 流量 限额 为 30M 的 通知 栏 图 6-40 流量 限额 为 50M 的 通知 栏 

下 面 来 看 这 个 安全 助手 用 到 了 本 章 哪些 新 技术 ， 机 灵 的 你 一 定 不 会 错过 以 下 4 点 。 

e 自 定义 日 期 对 话 框 : 最 上 面 的 标题 栏 ， 统 计 日 期 的 选择 对 话 框 可 采用 自 定 义 形 式 

e 自 定 义 圆 弧 动 画 : 页 面 上 方 的 流量 信息 ， 使 用 圆 弧 动 画展 示 当 天 的 已 用 流量 ， 并 通过 贺 
弧 颜 色 提醒 当前 流量 是 否 超标 。 

° 自 定义 通知 栏 : 通知 栏 中 包含 定制 样式 的 进度 条 ， 必 须 采 用 自 定 义 通知 栏 。 

e 服务 Service: 流量 数据 每 间隔 一 段 时 间 就 得 重新 获取 ， 这 种 定时 处 理 无 法 在 Acitivity 页 
面 进 行 ， 只 能 在 服务 Service 中 处 理 。 

另外 ， 安 全 助手 还 运用 了 多 种 存储 技术 ， 下 面 一 一 道 来 。 

e 数据库: 毫 无 疑问 ， 历 史 流量 数据 必须 保存 在 数据 库 中 。 

e 共享 参数 : 每 日 的 流量 限额 可 直接 保存 在 共享 参数 中 。 

e 全 局 内 存 : 也 许 读者 不 理解 这 里 跟 全 局 内 存 有 什么 关系 ， 其 实 全 局 内 存 要 保存 数据 库 连 
接 ， 因 为 主页 面 需要 通过 数据 库 查 询 流 量 数据 ， 后 台 服 务 也 要 不 断 获取 流量 数据 并 更 新 
至 数据 库 ， 既 然 不 止 一 个 地 方 用 到 数据 库 连 接 ， 不 如 统一 放 到 全 局 内 存 中 ， 还 可 以 避免 
因 资 源 释放 造成 别处 访问 不 了 的 异常 。 

如 此 看 来 ， 该 实战 项 目 不 但 可 以 演练 各 种 自 定义 控件 ， 而 且 可 以 复习 前 两 章 的 数据 存储 

技术 ， 可 谓 一 举 两 得 。 


662 ”小 知识 应 用 包 管 理 PackageManager 


手机 安全 管理 涉及 获取 已 安装 应 用 的 应 用 包 信息 ， 包 括 应 用 的 进程 编号 、 名 称 、 图 标 以 
及 流量 信息 。 其 中 ， 应 用 包 的 基本 信息 可 通过 PackageManager 与 ApplicationInfo 联合 获得 ， 
应 用 包 信 息 的 获取 代码 如 下 : 
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public static ArrayList<Applnfo> getApplnfo(Context ctx, int type) í 
ArrayList<Applnfo> appList = new ArrayList<Applnfo>(); 
SparseIntArray siArray = new SparselntArray(); 
PackageManager pm = ctx.getPackage Manager(); 
List<ApplicationInfo> installList = pm.getlnstalledApplications(PackageManager. 
PERMISSION GRANTED); 
for (int i-0; i-installList.size(); i++) í 
ApplicationInfo item — installList.get(i); 
if (siArray.indexOfKey(item.uid) >= 0) { // 去 掉 重复 的 应 用 信息 
continue; 
} 
siArray.put(item.uid, 1); 
ty ( 
String[] permissions = pm.getPackagelnfo(item.packageName, PackageManager. 
GET_PERMISSIONS).requestedPermissions; 
if (permissions == null) { 
continue; 
j 
boolean bNet = false; 
for (String permission : permissions) { 
if (permission.equals("android.permission.INTERNET")) í 
bNet true; 
break; 


j 

if (type==0 || (type—1 && bNet)) í 
AppiInfo app = new Applnfo(); 
app.uid = item.uid; 
app.label = item.loadLabel(pm).toString(); 
app.package name = item.packageName; 
app.icon = item.loadIcon(pm); 


appList.add(app); 
1 
) catch (Exception e) í 
e.printStackTrace(); 
continue; 
; 
; 
return appList; 


} 
应 用 产生 的 流量 数据 可 通过 工具 类 TrafficStats 读 取 ， 该 工具 有 以 下 6 种 常用 方法 。 
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6.6.3 


getTotalRxBytes: 获取 接收 流量 的 总 字 节 数 。 

getTotalTxBytes: 获取 发 送 流量 的 总 字 节 数 。 

getMobileRxBytes: 获取 数据 连接 接收 流量 的 总 字 节 数 。 包 含 移 动 数据 流量 ， 不 含 wf 
getMobileTxBytes: 获取 数据 连接 发 送 流量 的 总 字 节 数 。 

getUidRxBytes: 获取 指定 进程 接收 流量 的 总 字 节 数 。 

getUidTxBytes: 获取 指定 进程 发 送 流量 的 总 字 节 数 。 


代码 示例 


本 章 的 实战 项 目 依然 要 考虑 代码 架构 ， 故 而 编码 过 程 与 第 5 章 一 样 分 为 5 步 。 
ED) 设计 代码 架构 ， 初 步 拆 分 后 的 package 包 分 为 以 下 7 部 分 。 


com.example.assistant.activity: 存放 Acitivity 页 面 的 代码 。 
com.example.assistant.adapter: 存放 适配器 的 代码 。 

com.example.assistant.bean: 存放 实体 数据 结构 的 代码 ， 如 日 流量 的 字段 信息 。 
com.example.assistant.database: 存放 读 写 SQLite 的 数据 库 操作 代码 。 
com.example.assistant.service: 存放 服务 Service 的 代码 。 
com.example.assistant.util: 存放 工具 类 的 代码 。 

com.example.assistant.widget: 存放 自 定义 控件 的 代码 。 


EI 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 流量 主页 面 的 代码 文件 取 名 
MobileAssistantActivityjava， 对 应 的 布局 文件 名 是 activity_mobile_assistant.xml; 限额 设置 页 面 的 代码 
文件 取 名 MobileConfigActivityjava， 对 应 的 布局 文件 名 是 activity_mobile_config.xml。 不 要 忘 了 流量 
统计 服务 的 代码 文件 TrafficServicejava， 还 有 适配器 、 对 话 框 、 远 程 视图 的 代码 及 其 布局 文件 ， 读 者 
可 自行 构思 。 

€I 在 AndroidManifestxml 中 补充 相应 配置 ， 主 要 有 以 下 3 点 。 


1 


G 

















注册 两 个 页 面 的 acitivity 节点 ， 注 册 代 码 如 下 : 


«activity android:name=".MobileAssistantActivity" /> 
<activity android:name=".MobileConfigActivity" /> 


注册 流量 统计 服务 的 service 节点 ， 注 册 代 码 如 下 : 
«service android:name-" service.TrafficService" android:enabled="true" /> 
给 application 补充 name 属性 ， 值 为 MainApplication， 举 例如 下 : 


android:name=".MainApplication" 


CET 在 资源 目录 下 补充 相应 的 XML 配置 。 


G S 





在 res/drawable 目录 加 入 定制 进度 条 需要 的 层次 图 形 描述 文件 。 
在 res/layout 目录 下 编写 页 面 、 适 配器 、 对 话 框 、 远 程 视图 对 应 的 布局 文件 。 
在 res/values/styles.xml 中 补充 自 定义 日 期 对 话 框 的 样式 定义 。 
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EDG jv 代码 开发 ， 包 括 对 页 面 、 适 配器 、 对 话 框 、 后 台 服 务 等 进行 编码 。 
下 面 是 流量 统计 服务 TrafficService.java 的 完整 代码 : 


@TargetApi(Build.VERSION_CODES.JELLY_BEAN) 
public class TrafficService extends Service { 
private static final String TAG = "TrafficService"; 
private MainApplication app; 
private int limit day; 





private int mNowDay; 


@Override 
public int onStartCommand(Intent intent, int flags, int startid) í 
app = MainApplication.getInstance(); 
limit day = Integer.parseInt(SharedUtil.getIntance(this).readShared("limit day", "30")); 
mHandler.post(mRefresh); 
return START. STICKY; 
j 


private Handler mHandler = new Handler); 
private Runnable mRefresh = new Runnable() í 
@Override 
public void run() { 
refreshData(); 
refreshNotify(); 
mHandler.postDelayed(this, 10000); 


h 


private void refreshData() í 
mNowDay = Integer.parselInt( DateUtil.getNowDateTime("yyyyMMdd")); 
/获取 最 新 的 流量 信息 
ArrayList<Applnfo> appinfoList = AppUtil.getAppInfo(this, 1); 
for (int i=0; i<appinfoList.size(); i++) { 
Applnfo item = appinfoList.get(i); 
item.traffic = TrafficStats.getUidRxBytes(item.uid); 
item.month = mNowDay/100; 
item.day = mNowDay; 
appinfoList.set(i, item); 
; 
app.mTrafficHelper.insert(appinfoL ist); 
} 
private void refreshNotify() í 


String last date = DateUtil.getAddDate(""+mNowDay, -1); 
ArrayList-ApplInfo- lastArray = app.m TrafficHelper.query("day-"--last date); 
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ArrayList<Applnfo> thisArray = app.mTrafficHelper.query("day="+mNowDay); 
long traffic_day = 0; 
for (int i-0; i<thisArray.size(); i++) { 
Applnfo item = thisArray.get(i); 
for (int j=0; j<lastArray.size(); j++) í 
if (item.uid == lastArray.get(j).uid) í 
item.traffic -= lastArray.get(j).traffic; 
break; 


j 
traffic day += item.traffic; 
$ 
String desc = "今日 已 用 流量 " + StringUtil.formatTraffic(traffic day); 
int progress = 0; 
int layoutld = R.layout.notify_traffic_green; 
float trafficM = traffic day/1024.0f/1024.0f; 
if (trafficM > limit day*2) í 
progress = (int) ((trafficM^limit day*3)?100:(trafficM-limit day*2)*100/limit day); 
layoutld = R.layout.notify traffic red; 
} else if (trafficM > limit day) í 
progress = (int) ((trafficM^limit day*2)?100:(trafficM-limit day)*100/limit day); 
layoutId = R.layout.notify traffic yellow; 
} else í 
progress = (int) (trafficM*100/limit day); 
J 
Log.d(TAG, "progress="+progress); 
RemoteViews notify traffic = new RemoteViews(this.getPackageName(), layoutld); 
notify traffic.setTextViewText(R.id.tv flow, desc); 
notify traffic.setProgressBar(R.id.pb flow, 100, progress, false); 
Intent intent = new Intent(this, MainActivity.class); 
PendingIntent contentIntent = PendingIntent.getActivity(this, 

R.string.app. name, intent, PendingInten.FLAG UPDATE. CURRENT); 
Notification.Builder builder = new Notification.Builder(this); 
builder.setContentIntent(contentIntent).setContent(notify traffic) 

.setTicker(" 手 机 安全 助手 运行 中 ").setSmalllcon(R.drawable.ic_app); 
mNotify = builder.build(); 
startForeground(9, mNotify); 

} 


private Notification mNotify; 
@Override 
public void onDestroy() { 
super.onDestroy(); 
if (mNotify != null) { 
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stopForeground(true); 
} 


(@Override 

public IBinder onBind(Intent intent) í 
return null; 

} 


67 小 结 


本 章 主要 介绍 了 App 开发 的 自 定义 控件 相关 知识 ， 包 括 自 定义 视图 的 步骤 〈 声 明 属性 、 
构造 对 象 、 测 量 尺寸 、 绘 制 视图 ) 、 自 定义 简单 动画 《任务 片段 、 下 拉 刷 新 动画 、 圆 弧 进度 动 
画 ) 、 自 定义 对 话 框 的 操作 《对 话 框 、 改 进 日 期 对 话 框 、 自 定义 多 级 对 话 框 ) 、 自 定义 通知 栏 
的 用 法 〈 通 知 推送 、 进 度 条 、 远 程 视图 ) 、Service 组 件 的 基本 用 法 〈 生 命 周期 、3 种 启 停 方式 、 
推送 服务 到 前 台 ) 。 最 后 设计 了 一 个 实战 项 目 “ 手 机 安全 助手 ”， 在 该 项 目的 App 编码 中 采 
用 了 本 章 介绍 的 大 部 分 自 定义 控件 知识 ， 以 及 服务 启 停 和 推送 到 通知 栏 的 处 理 。 另 外 , 还 介绍 
了 如 何 获取 手机 上 的 应 用 包 信 息 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 。 

(1) 学 会 自 定义 简单 控件 ， 包 括 静 止 的 视图 和 简单 的 动画 。 

OD 学 会 自 定义 对 话 框 ， 在 页 面 的 合适 位 置 显示 和 控制 对 话 框 。 

(3) 学 会 自 定义 通知 栏 ， 包 括 自 定义 样式 与 自 定义 操作 的 处 理 。 

(4) 学 会 Service 组 件 的 用 法 ， 如 启 停 服务 、 绑 定 / 解 绑 服 务 、 把 服务 推送 到 前 台 等 。 
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s /a 组 合 控件 


本 章 介绍 App 开发 常用 的 一 些 组 合 控件 ， 主 要 包括 底 
部 标签 栏 的 实现 和 用 法 、 顶 部 导航 栏 的 用 法 、 横幅 轮 播 条 的 
实现 和 用 法 、 循 环视 图 3 种 布局 的 用 法 等 。 最 后 结合 本 章 所 
学 的 知识 演示 一 个 实战 项 目 “ 仿 淘 宝 主页 ”的 设计 与 实现 。 





DA GR 
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7.4 i E 栏 


本 节 介绍 底部 标签 栏 的 实现 与 用 法 ， 首 先 说 明 如 何 自 定义 实现 标签 按钮 ， 然 后 介绍 标签 
栏 的 3 种 实现 方式 ， 即 TabActivity 方式 、ActivityGroup 方式 和 FragmentActivity 方式 。 


7.1.1 标签 按钮 


按钮 控件 种 类 繁多 ， 有 文本 按钮 Button、 图 像 按钮 ImageButton、 单 选 按钮 RadioButton, 
复 选 按钮 CheckBox 、 开 关 按 钮 Switch 等 ， 可 展现 的 
形式 有 文本 、 图 像 、 文 本 + 图 标 ， 如 此 丰富 的 展现 形 | D orm 
式 ， 已 经 能 够 满足 大 部 分 控制 需求 。 但 总 有 少数 场合 ce 
比较 特殊 ， 一 般 的 按钮 样式 满足 不 了 ， 比 如 图 7-1 所 " 
示 的 微 信 底 部 标签 栏 ， 一 排 有 4 个 标签 按钮 ， 每 个 按 
钮 的 图 标 和 文字 都 会 随 着 选中 操作 而 高 亮 显示 。 
这 样 的 标签 栏 控件 是 各 大 主流 App 的 标 配 ， 无 论 是 淘宝 、 京 东 ， 还 是 微 信 、 手 机 QQ， 首 
屏 底部 一 律 是 清一色 的 标签 栏 ， 而 且 在 选中 标签 按钮 时 经 常 文字 、 图 标 、 背 景 一 起 高 亮 显示 。 
像 这 种 标签 按钮 ，Android 似乎 没有 对 应 的 专门 控件 ， 如 果 要 自 定 义 控件 ， 就 得 设计 一 个 布局 
容器 , 里 面 放 入 一 个 文本 控件 和 图 像 控 件 , 然后 注册 选中 事件 的 监听 器 , 一 旦 监听 到 选中 事件 ， 
就 高 亮 显示 文字 、 图 标 与 布局 背景 。 
自 定义 控件 固然 是 一 个 不 错 的 思路 ， 不 过 无 须 如 此 大 动 干戈 。 读 者 还 记得 第 2 章 介 绍 开 
关 按钮 Switch 时 结合 状态 图 形 与 复 选 框 实现 仿 iOS 开关 按钮 的 例子 吧 ， 通 过 状态 图 形 自动 展 
示 选 中 与 未 选中 两 种 状态 的 图 像 在 外 观 上 就 像 一 个 新 控件 。 标签 控件 也 是 如 此 ， 要 想 高 亮 显示 
背景 ,可 通过 给 background 属性 设置 状态 图 形 ; 要 想 高 亮 显示 图 标 ， 可 通过 给 drawableTop 属 
性 设置 状态 图 形 ; 高 亮 显示 文本 也 能 通过 给 textColor 属性 设置 状态 图 形 实现 。 这 个 小 技巧 估 
计 很 多 人 都 没 用 过 ， 既 然 文字 、 图 标 、 背 景 都 可 以 通过 StateDrawable 控制 是 否 高 亮 显示 ， 接 
下 来 的 事情 就 好 办 了 ， 具 体 的 实现 步骤 如 下 : 
人 ED) 定义 一 个 状态 图 形 的 XML 描述 文件 ， 当 状态 为 选中 时 展示 高 亮 图 形 ， 代 码 如 下 : 
«selector xmlns:android="http://schemas.android.com/apk/res/android"> 
<item android:state _selected="true" android:color="@color/tab_text_selected" /> 
<item android:color="(@color/tab_text_normal" /> 
</selector> 
CX302 在 布局 文件 中 给 TextView 控件 的 background, textColor, drawableTop 三 个 属性 分 别 设 
置 对 应 的 状态 图 形 ， 设 置 代码 举例 如 下 : 
<TextView 
android:id-"Q)*id/tv tab button" 
android:layout width-"l00dp" 





图 7-1 微 信 的 底部 标签 栏 
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android:layout height-"60dp" 

android:padding-"5dp" 

android:layout gravity-"center" 
android:gravity-"center" 
android:background-"(g)drawable/tab bg selector" 
android:text=" 点 我 " 

android:textSize="12sp" 
android:textColor="@drawable/tab_text_selector" 
android:drawable Top="@drawable/tab_first_selector" /> 


03 在 代码 中 调用 TextView 对 象 的 setSelected(true) 方 法 时 ， 该 控件 的 文字 、 图 标 、 背 景 同 
时 高 亮 显 示 ; 调用 setSelected(false) 方 法 时 ， 该 控件 的 文字 、 图 标 、 背 景 恢复 原状 。 具 体 效果 如 图 7-2 
和 图 7-3 所 示 ， 图 7-2 所 示 为 尚未 选中 时 的 截图 ， 图 7-3 所 示 为 选中 时 的 截图 。 













































































Group 
选 定 标签 按钮 选 定 标签 按钮 
2 
en 
图 7-2 ”未 选中 标签 按钮 的 截图 图 7-3 选中 标签 按钮 的 截图 


是 不 是 很 神奇 ? 接 下 来 我 们 把 该 控件 的 共同 属性 挑 出 来 ， 因 为 底部 标签 栏 有 4、5 个 标签 
按钮 , 如 果 每 个 按钮 节点 都 添加 重复 的 属性 , SK AKU Y, 所 以 把 它们 之 间 通 用 的 属性 挑 出 来 ， 
然后 在 values/styles.xml 中 定义 名 为 TabButton 的 新 风格 ， 具 体 的 定义 代码 如 下 : 


<style name="TabButton"> 

«item name="android:layout_width">match_parent</item> 

<item name="android:layout_height">match_parent</item> 

«item name="android:padding">5dp</item> 

<item name="android:layout_gravity">center</item> 

<item name="android:gravity">center</item> 

«item name="android:background">(@drawable/tab_bg_selector</item> 

<item name="android:textSize">12sp</item> 

«item name="android:textStyle">normal</item> 

<item name="android:textColor">(@drawable/tab_text_selector</item> 
</style> 


接 下 来 ， 布 局 文件 只 要 给 TextView 节点 添加 一 行 style="@style/TabButton"， 即 可 完成 标 
签 按钮 的 声明 。 直 接 在 styles.xml 中 定义 风格 ， 无 须 另外 编写 自 定义 控件 的 代码 ， 这 是 自 定义 
控件 的 另 一 种 途径 。 


7.1.2 ”实现 底部 标签 栏 


有 了 单个 标签 按钮 ， 还 需要 一 个 边框 把 这 些 按钮 放 进去 ， 自 动 响应 每 个 按钮 的 点 击 操作 ， 
才能 形成 一 个 真正 可 用 的 底部 标签 栏 。 由 于 点 击 标签 切换 页 面 时 标签 栏 自身 仍 保持 不 动 , 因此 























Android Studio RRR: JE SER] App 上线 





这 种 情况 不 宜 直 接 采 用 通常 的 活动 页 面 跳 转 ， 只 能 通过 特定 形式 完成 页 面 切换 。 
标签 栏 的 页 面 切换 主要 有 3 种 方式 : 基于 TabActivity 的 标签 栏 、 基 于 ActivityGroup 的 标 
签 栏 和 基于 FragmentActivity 的 标签 栏 ，3 种 方式 各 有 千秋 。 


1. 基于 TabActivity 的 标签 栏 


TabActivity 原本 就 是 设计 用 来 做 标签 页 面 的 ， 并 且 提供 了 TabHost 和 TabWidget 两 个 控 
件 ， 只 不 过 它们 仅 用 于 标签 栏 ， 所 以 无 须 深入 了 解 ， 套 用 固定 的 框架 就 行 。 
下 面 是 TabActivity 方式 的 布局 文件 代码 : 


<TabHost xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="(@android:id/tabhost" 
android:layout width-"match parent" 
android:layout height-"match parent" > 


*RelativeLayout 
android:layout width-"match parent" 
android:layout height-"match parent" > 


*FrameLayout 
android:id-" (aandroid:id/tabcontent" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:layout marginBottom-"(g)dimen/tabbar height" /> 


«TabWidget 
android:id-" (aandroid:id/tabs" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:visibility-"gone" /> 


«LinearLayout 
android:layout width-"match parent" 
android:layout height-"(gdimen/tabbar height" 
android:layout alignParentBottom-"true" 
android:gravity-"bottom" 
android:orientation-"horizontal" > 


«LinearLayout 
android:id-"(a)*id/ll first" 
android:layout width="0dp" 
android:layout height-"match parent" 
android:layout weight-"1" 
android:orientation-" vertical" > 
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<TextView 
style="(@style/TabButton" 
android:drawableTop="@drawable/tab_first_selector" 
android:text="(@string/menu first" /> 
</LinearLayout> 


<LinearLayout 
android:id="(@+id/ll_second" 
android:layout_width="0dp" 
android:layout height-"match parent" 
android:layout weight-" 1" 
android:orientation-" vertical" > 


«TextView 
style-"(a)style/TabButton" 
android:drawableTop-"(a)drawable/tab second selector" 
android:text-"(string/menu second" /> 
«/LinearLayout^ 


*LinearLayout 
android:id—" (2)*id/ll. third" 
android:layout width-"Odp" 
android:layout height-"match parent" 





android:layout weight-" 1" 
android:orientation-" vertical" > 


«TextView 
style="(@style/TabButton" 
android:drawableTop-"(a)drawable/tab third selector" 
android:text-"(gstring/menu third" /> 
«/LinearLayout^ 
«/LinearLayout^ 
*/RelativeLayout^ 
«/TabHost^ 


有 了 布局 文件 ， 再 来 看 对 应 的 Activity 框架 ， 下 面 是 TabActivity 的 代码 : 


public class TabHostActivity extends TabActivity implements OnClickListener í 
private static final String TAG = "TabHostActivity"; 
private Bundle mBundle = new Bundle(); 
private TabHost tab host; 
private LinearLayout ll. first, ll second, ll. third; 
private String FIRST TAG = "first"; 








Android Studio TF 328: 从 零 基础 到 App Ex 





private String SECOND TAG = "second"; 
private String THIRD TAG = "third"; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 

super.onCreate(savedInstanceState); 

setContentView(R.layout.activity tab host); 

mBundle.putString("tag", TAG); 

Il. first = (LinearLayout) findViewById(R.id.ll first); 

Il second = (LinearLayout) find ViewById(R.id.ll second); 

Il third = (LinearLayout) find ViewById(R.id.ll third); 

ll. first.setOnClickListener(this); 

ll second.setOnClickListener(this ); 

Il third.setOnClickListener(this); 

tab host = getTabHost(); 

tab host.addTab(getNewTab(FIRST TAG, R.string.menu first, 
R.drawable.tab first selector, TabFirstActivity.class)); 

tab host.addTab(getNewTab(SECOND TAG, R.string.menu second, 
R.drawable.tab second selector, TabSecondActivity.class)); 

tab hostaddTab(getNewTab(THIRD TAG, R.string.menu third, 
R.drawable.tab third selector, TabThirdActivity.class)); 

tab host.setCurrentTabByTag(FIRST TAG); 

changeContainerView(ll first); 


private TabHost. TabSpec getNewTab(String spec, int label, int icon, Class<?> cls) í 
Intent intent = new Intent(this, cIs).putExtras(mBundle); 
return tab host.newTabSpec(spec).setContent(intent) 
.setIndicator(getString(label), getResources().getDrawable(icon)); 


@Override 
public void onClick(View v) { 
if (v.getld()==R.id.ll_first || v.getId)=R.id.ll_second || v.getld()=—R.id.ll_third) í 
changeContainerView(v); 


private void changeContainerView(View v) í 
ll. first.setSelected(false); 
Il second.setSelected(false); 
Il. third.setSelected(false); 
v.setSelected(true); 








组 合 控件 # 73 





if (v= |l first) í 
tab_host.setCurrentTabByTag(FIRST_TAG); 
} else if (v = ll second) í 
tab host.setCurrentTabByTag(SECOND TAG); 
1 else if (v = II third) í 
tab host.setCurrentTabByTag(THIRD TAG); 
y 


$ 

该 方式 的 核心 是 getNewTab 函数 ， 方 法 内 部 可 设置 标签 按钮 的 文本 、 图 标 以 及 该 标签 对 
应 的 活动 页 面 。 当 发 生 标 签 按 钮 的 点 击 事件 时 ， 系 统 调用 TabHost 的 setCurrentTabByTag 方法 
定位 具体 的 切换 页 面 。 

具体 的 标签 页 切换 效果 如 图 7-4 和 图 7-5 所 示 。 其 中 ， 图 7-4 所 示 为 点 击 “ 首 页 ”标签 按 
钮 时 的 截图 ， 图 7-5 所 示 为 点 击 “ 分 类 ”标签 按钮 时 的 截图 。 


我 是 首页 页面， 来 自 TabHostActivity 我 是 分 类 页 面 ， 来 自 TabHostActivity 


会 





图 7-4 ”点击 “首页 ”标签 按钮 图 7-5 点 击 “ 分 类 ”标签 按钮 
2. 基于 ActivityGroup 的 标签 栏 


顾名思义 ，ActivityGroup 就 是 Activity 的 组 合 ， 允 许 在 内 部 开启 活动 页 面 。 从 这 个 意义 上 
来 说 , ActivityGroup 与 Activity 的 关系 相当 于 Activity 与 Fragment 的 关系 。 使 用 ActivityGroup 
实现 标签 栏 有 固定 的 模板 ， 下 面 是 ActivityGroup 方式 的 布局 文件 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<LinearLayout 
android:id="@+id/ll_container" 
android:layout_width="match_parent" 
android:layout_height="0dp" 
android:layout_weight="1" 
android:gravity="bottom|center" 
android:orientation="horizontal" /> 

<LinearLayout 
android:layout width-"match parent" 
android:layout height-"(g)dimen/tabbar height" 
android:orientation-"horizontal" ^ 
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«LinearLayout 
android:id="(@+id/ll_ first" 
android:layout width="0dp" 
android:layout height-"match parent" 
android:layout weight-"1" 
android:orientation-" vertical" > 


«TextView 
style=" @style/TabButton" 
android:drawableTop="(@drawable/tab_first_selector" 
android:text="(@string/menu_ first" /> 
</LinearLayout> 


<LinearLayout 
android:id="(@+id/ll_second" 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="1" 
android:orientation="vertical" > 


<TextView 
style=" @style/TabButton" 
android:drawableTop="(@drawable/tab_second_selector" 
android:text="(@string/menu_second" /> 
</LinearLayout> 


<LinearLayout 
android:id="@+id/ll_third" 
android:layout_width="0dp" 
android:layout_height="match_parent" 
android:layout_weight="1" 
android:orientation="vertical" > 


<TextView 
style=" @style/TabButton" 
android:drawableTop="(@drawable/tab_third_selector" 
android:text="(@string/menu_third" /> 
</LinearLayout> 
</LinearLayout> 
</LinearLayout> 


与 上 面 的 布局 文件 对 应 的 是 ActivityGroup 的 代码 : 


public class TabGroupActivity extends ActivityGroup implements OnClickListener { 
private static final String TAG = "TabGroupActivity"; 
private Bundle mBundle = new Bundle(); 
private LinearLayout ll. container, ll. first, ll. second, ll third; 
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@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity tab group); 
Il container = (LinearLayout) findViewByld(R.id.ll container); 
Il. first = (LinearLayout) findViewById(R.id.ll first); 
ll second = (LinearLayout) find ViewById(R.id.ll second); 
Il third = (LinearLayout) find ViewById(R.id.ll third); 
Il. first.setOnClickListener(this); 
Il second.setOnClickListener(this); 
ll. third.setOnClickListener(this); 
mBundle.putString("tag", TAG); 
changeContainerView(ll first); 


(a Override 
public void onClick(View v) f 
if (v.getId()——R.id.ll first || v.getId()—R.id.ll second || v.getId()—R.id.ll third) í 
changeContainerView(v); 


private void changeContainerView(View v) f 
Il. first.setSelected(false); 
Il. second.setSelected(false); 
ll. third.setSelected(false); 
v.setSelected(true); 
if (v = Il first) í 
toActivity("first", TabFirstActivity.class); 
) else if (v = Il second) í 
toActivity("second", TabSecondActivity.class); 
1 else if (v = l third) { 
toActivity("third", TabThirdActivity.class); 


private void toActivity(String label, Class<?> cls) í 
Intent intent = new Intent(this, cIs).putExtras(mBundle); 
Il container.removeAllIViews(); 
View v — getLocalActivityManager().startActivity(label, intent).getDecorView(); 
v.setLayoutParams(new LayoutParams( 
LayoutParams. MATCH PARENT, LayoutParams. MATCH PARENT)); 
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ll container.addView(v); 


; 

该 方式 的 核心 是 toActivity 函数 ， 方 法 内 部 可 设置 标签 按钮 的 文本 、 图 标 以 及 该 标签 对 应 
的 活动 页 面 。 从 函数 中 可 以 看 到 ，startActivity 方法 返回 一 个 Window 对 象 ， 然 后 从 该 Window 
对 象 提 取 标 签 页 的 实际 视图 〈 调 用 getDecorView 方法 ) 。 我 们 可 以 把 DecorView 理解 为 该 标 
签 页 的 根 视图 ， 将 这 个 根 视 图 DecorView 加 入 ActivityGroup 的 视图 容器 中 。 注 意 ， 这 里 在 调 
用 startActivity 方法 前 需要 先 调 用 getLocalActivityManager 方法 获得 页 面 管理 器 ， 才 能 进行 后 
续 操 作 ，getLocalActivityManager 方法 是 ActivityGroup 特有 的 函数 。 

该 方式 的 标签 栏 页 面 效 果 与 TabActivity 一 样 。 为 了 区 分 两 种 方式 ， 这 里 在 具体 标签 页 中 
把 来 源 打 印 出 来 ， 如 图 7-6 和 图 7-7 所 示 。 其 中 ， 图 7-6 所 示 为 点 击 “ 首 页 ”标签 按钮 时 的 截 
图 ， 图 7-7 所 示 为 点 击 “ 购 物 车 ”标签 按钮 时 的 截图 。 








我 是 首页 页 面 ， 来 自 TabGroupActivity 我 是 购物 车 页 面 ， 来 自 TabGroupActivity 


2 í 区 


首页 





图 7-6 点 击 “ 首 页 ”标签 按钮 图 7-7 点击“ 购物 车 ”标签 按钮 
3. 基于 FragmentActivity 的 标签 栏 


前 面 提 到 ，ActivityGroup 方式 采用 一 个 ActivityGroup 对 应 多 个 Activity 的 做 法 ， 那 么 也 
可 以 采取 一 个 Activity 对 应 多 个 Fragment 的 做 法 , 基于 FragmentActivity 的 标签 栏 就 是 该 思路 
的 第 3 种 方式 。 与 前 两 种 方式 一 样 ，FragmentActivity 也 有 固定 的 使 用 模板 ， 下 面 是 该 方式 的 
布局 文件 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout_width="match parent" 
android:layout height-"match parent" 
android:orientation-" vertical" > 


<!-- 把 FragmentLayout 放 在 FragmentTabHost 上 面 ， 标 签 页 就 在 页 面 底部 ; 
反之 FragmentLayout 在 FragmentTabHost 下 面 ， 标 签 页 就 在 页 面 顶部 。 --> 
<FrameLayout 
android:id="(@+id/realtabcontent" 
android:layout width-"match parent" 
android:layout height-"Odp" 
android:layout weight-"l" /> 
«android.support.v4.app.FragmentTabHost 
android:id-"(a)android:id/tabhost" 
android:layout width-"match parent" 
android:layout height-"(g dimen/tabbar height" > 





组 合 控件 # 73 





<FrameLayout 
android:id="(@android:id/tabcontent" 
android:layout width="0dp" 
android:layout height="0dp" 
android:layout weight-"0" > 


«/android.support.v4.app.FragmentTabHost^ 
«/LinearLayout^ 


看 起 来 布局 文件 简洁 了 许多 ， 该 方式 的 代码 也 同样 简洁 了 : 
public class TabFragmentActivity extends FragmentActivity { 


private static final String TAG = "TabFragmentActivity"; 
private FragmentTabHost mTabHost; 





(a Override 
protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity tab fragment); 
Bundle bundle = new Bundle(); 
bundle.putString("tag", TAG); 
mTabHost = (FragmentTabHost) find ViewByld(android.R.id.tabhost); 
mTabHost.setup(this, getSupportFragmentManager(), R.id.realtabcontent); 
//addTab( 标 题 ， 跳 转 的 Fragment， 传 递 参数 的 Bundle) 
mTabHost.addTab(getTabView(R.string.menu first, R.drawable.tab first selector), 
TabFirstFragment.class, bundle); 
mTabHost.addTab(getTabView(R.string.menu second, R.drawable.tab second selector), 
TabSecondFragment.class, bundle); 
mTabHost.addTab(getTabView(R.string.menu third, R.drawable.tab third selector), 
TabThirdFragment.class, bundle); 
/设置 tabs 之 间 的 分 隔 线 不 显示 
mTabHost.getTabWidget().setShowDividers(LinearLayout.SHOW DIVIDER NONE); 


private TabSpec getTabView(int textId, int imgId) í 
String text = getResources().getString(textId); 
Drawable drawable = getResources().getDrawable(imglId); 
/必须 设置 图 片 大 小 ， 否 则 不 显示 
drawable.setBounds(0, 0, drawable.getMinimumWidth(), drawable.getMinimumHeight()); 
//R.layout.item tabbar 是 单个 标签 按钮 的 布局 文件 
View item tabbar = getLayoutInflater().inflate(R.layout.item tabbar, null); 
TextView tv item = (TextView) item tabbar.findViewById(R.id.tv item tabbar); 
tv item.setText(text); 
tv item.setCompoundDrawables(null, drawable, null, null); 
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TabSpec spec = mTabHost.newTabSpec(text).setIndicator(item tabbar); 
return spec; 


} 


FragmentActivity 方式 的 核心 是 addTab 函数 , 内 部 可 自 定义 每 个 标签 按钮 的 视图 和 对 应 的 
Fragment 页 面 。 因 为 FragmentTabHost 已 经 自动 处 理 了 点 击 事件 ,所 以 无 须 另外 调用 setSelected 
方法 。 该 方式 与 前 两 种 方式 的 不 同 之 处 在 于 标签 页 是 Fragment 而 不 是 Activity, 因此 标签 页 内 
部 无 法 直接 操作 选项 菜单 。 

FragmentActivity 方式 的 标签 栏 与 前 两 种 方式 在 形式 上 没什么 差别 ， 具 体 效果 如 图 7-8 和 
图 7-9 所 示 。 其 中 ， 图 7-8 所 示 为 点 击 “ 分 类 ”标签 按钮 时 的 截图 ， 图 7-9 所 示 为 点 击 “ 购 物 
车 ”标签 按钮 时 的 截图 。 


我 是 分 类 页 面 ， 来 自 TabFragmentActivity 我 是 购物 车 页 面 ， 来 自 TabFragmentActivity 


8 * a e 


2n m4 mm z 购物 车 





图 7.8 点 击 “ 分 类 " PRERA 图 7.9 点 击 “购物 车 ” decl 
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本 节 介 绍 导航 栏 的 组 成 控件 ， 包 括 工具 栏 Toolbar、 洪 出 菜单 OverflowMenu、 搜 索 框 
SearchView、 标 签 布局 TabLayout 的 相关 用 法 ， 以 及 如 何 定 制 Toolbar 的 视图 与 TabLayout 的 
标签 页 。 

7.2.1 工具 栏 Toolbar 


主流 App 除了 底部 有 一 排 标 签 栏 外 ， 通 常 顶部 还 有 一 排 导航 栏 。 在 Android5.0 之 前 ， 这 
个 顶部 导航 栏 以 ActionBar 控件 的 形式 出 现 ， 但 ActionBar 存在 不 灵活 、 难 以 扩展 等 毛病 ， 所 
以 Android5.0 之 后 推出 了 Toolbar 工具 栏 控件 ， 意 在 取代 ActionBar。 

不 过 为 了 兼容 之 前 的 版 本 ，ActionBar 控件 仍然 保留 。Toolbar 与 ActionBar 都 占 着 顶部 导 
航 栏 的 位 置 ， 要 想 引 入 Toolbar 就 得 先 关闭 ActionBar。 具 体 的 操作 步骤 如 下 : 

ED 在 styles.xml 中 定义 一 个 不 包含 ActionBar 的 风格 样式 ， 代 码 如 下 : 

<style name-"AppCompatTheme" parent="Theme.AppCompat.Light.NoActionBar" /> 

CX02 修改 AndroidManifestxml， 把 activity 节点 的 android:theme 属性 值 改 为 第 一 步 定 义 的 风 
格 ， 如 android:theme="(@style/AppCompatTheme"。 

EID 将 页 面 布局 文件 的 根 节点 改 为 LinearLayout， 且 为 vertical 垂直 方向 ， 然 后 增加 一 个 
Toolbar 元 素 ， 因 为 Toolbar 本 质 是 一 个 ViewGroup， 所 以 也 可 以 在 下 面 添加 别 的 控件 。 下 面 是 一 个 布 
局 文件 的 片段 : 
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<android.support.v7.widget.Toolbar 


ce 


是 默认 继承 AppCompatActivity 了 。 然 后 在 onCreate 函数 中 获取 布局 文件 中 的 Toolbar 对 象 ， 并 调用 


android:id-"(g)*id/tl head" 
android:layout width-"match parent" 
android:layout height-"wrap content" /> 


将 Activity 代码 改 为 继承 自 AppCompatActivity, 其 实在 Android Studio 中 新 建 模块 已 经 























setSupportActionBar 方 法 设置 当前 的 Toolbar 对 象 。 


Toolbar 


之 所 以 比 ActionBar 灵活 , 原因 是 Toolbar 提供 了 多 个 属性 指定 控件 风格 。Toolbar 


的 常用 属性 及 设置 方法 见 表 7-1〈 自 定义 属性 的 用 法 参见 第 6 章 的 “6.1.1 声明 属性 ”) 。 


表 7-1 Toolbar 的 常用 属性 及 设置 方法 说 明 














XML 中 的 属性 Toolbar 类 的 设置 方法 说 明 

logo setLogo 设置 工具 栏 图 标 

title setTitle 设置 标题 文字 

titleTextColor setTitleTextColor 设置 标题 的 文字 颜色 

titleTextAppearance setTitleTextAppearance 设置 标题 的 文字 风格 。 风 格 定义 在 styles.xml 中 
subtitle setSubtitle 设置 副标题 文字 。 副 标题 在 标题 下 方 
subtitleTextColor setSubtitleTextColor 设置 副标题 的 文字 颜色 

subtitleTextAppearance setSubtitleTextAppearance 设置 副标题 的 文字 风格 

navigationIcon setNavigationlcon 设置 左 侧 导航 图 标 

Xx setNavigationOnClickListener | 设置 导航 图 标的 点 击 监听 器 





下 面 是 使 用 Toolbar 的 代码 片段 : 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 

setContentView(R.layout.activity_toolbar); 

Toolbar tl head = (Toolbar) find ViewById(R.id.tl head); 

tl head.setNavigationIcon(R.drawable.ic back); 

tl head.setTitle(" T. R. 9t fij"); 

tl. head.setTitleTextColor(Color.RED); 

tl head.setLogo(R.drawable.ic app); 

tl. head.setSubtitle(" Toolbar"); 

tl head.setSubtitleTextColor(Color. YELLOW); 

tl head.setBackgroundResource(R.color.blue light); 

setSupportActionBar(tl head); 

//setNavigationOnClickListener 必须 放 到 setSupportActionBar 之 后 ， 不 然 不 起 作用 

tl head.setNavigationOnClickListener(new OnClickListener() í 
@Override 
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public void onClick(View view) í 


finish(); 
D 
» 
} 
具体 的 工具 栏 效 果 如 图 7-10 Bros, iE LR [€ diit 
元 素 包括 导航 图 标 、 工 具 栏 图 标 、 标 题 、 副 标题 。 BATARIA 





722 溢出 菜单 OverflowMenu 


7-10 简单 设置 后 的 工具 栏 界 面 
导航 栏 右边 往往 有 个 三 点 图 标 ， 点 击 后 会 弹出 菜单 。 这 个 右上 角 的 弹出 菜单 名 叫 溢出 菜 
单 OverflowMenu, 意 指导 航 栏 不 够 放 了 、 溢 出 来 了 。 溢 出 菜单 其 实 就 是 把 选项 菜单 OptionsMenu 
搬 到 了 页 面 右 上 方 ， 具 体 的 菜单 布局 与 代码 用 法 基本 同 选项 菜单 ， 不 同 之 处 在 于 溢出 菜单 多 了 
个 showAsAction 属性 , 该 属性 用 来 控制 菜单 项 在 导航 栏 上 的 展示 位 置 , 具体 的 取 值 说 明 见 表 7-2。 


表 7-2 菜单 项 展示 位 置 类 型 的 取 值 说 明 


展示 位 置 类 型 说 明 

always 总 是 在 导航 栏 上 显示 菜单 图 标 

ifRoom 如 果 导 航 栏 右 侧 有 空间 ， 该 项 就 直接 显示 在 导航 栏 上 ， 不 再 放 入 溢出 菜单 
never 从 不 在 导航 栏 上 直接 显示 ， 一 直 放 在 溢出 菜单 列表 里 面 

withText 如 果 能 在 导航 栏 上 显示 ， 除 了 显示 图 标 ， 还 要 显示 该 项 的 文字 说 明 





操作 视图 要 折 受 为 一 个 按钮 ， 点 击 该 按钮 再 展开 操作 视图 ， 主 要 用 于 SearchView 


collapseActionView 


默认 情况 下 ， 菜 单列 表 的 菜单 项 不 会 在 文字 左边 显示 图 标 ， 即 使 在 菜单 布局 中 设置 了 icon 
属性 也 没有 作用 。 所 以 想 让 菜单 项 显示 左 侧 图 标 就 得 调用 MenuBuilder 的 setOptionallconsVisible 
方法 。 该 方法 是 一 个 隐藏 方法 ， 只 能 通过 反射 机 制 调用 。 具 体 的 调用 代码 如 下 : 
public static void setOverflowIconVisible(int featureld, Menu menu) í 
// ActionBar 的 featureld 是 8, Toolbar 的 featureld 是 108 
if (featureld % 100 == Window.FEATURE ACTION BAR && menu != null) í 
if (menu.getClass().getSimpleName().equals("MenuBuilder")) í 
try { 
Method m = menu.getClass().getDeclaredMethod( 
"setOptionallconsVisible", Boolean.TY PE); 
m.setAccessible(true); 
m.invoke(menu, true); 
} catch (Exception e) í 
e.printStackTrace(); 
j 
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另外 ， 菜 单 布局 中 将 showAsAction 属性 设置 为 ifRoom 或 always， 不 过 即使 工具 栏 上 还 
有 空间 ， 该 菜单 项 也 不 会 显示 在 工具 栏 上 。 这 方面 也 很 不 好 ， 因 为 在 ActionBar 时 代 ， 这 么 做 
没 问题 ， 到 Toolbar 时 代 反 而 出 了 问题 。 既 然 有 问题 就 得 解决 ， 解 决 办 法 挺 简单 ， 首 先 在 菜单 
布局 的 menu 根 节点 增加 命名 空间 声明 xmins:app-"http://schemas.android.com/apk/res-auto" , #& 
RAE? 这 分 





后 把 android:showAsAction="ifRoom" 改 为 app:showAsAction="ifRoom"。 很 眼熟 是 
明 就 是 自 定义 属性 的 做 法 。 下 面 来 看 用 于 溢出 菜单 的 布局 文件 代码 : 


<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" > 

















<item 
android:id="(®+id/menu_refresh" 
android:orderInCategory="1" 
android:icon="(@drawable/ic_refresh" 
app:showAsAction="ifRoom" 
android:title=" 刷 新 "/> 


<item 
android:id="(@+id/menu_about" 
android:orderlnCategory="8" 
android:icon="(@drawable/ic_about" 
app:showAsAction="never" 
android:title=" 关 于 "/> 


<item 
android:id="(@+id/menu_quit" 
android:orderInCategory="9" 
android:icon="@drawable/ic_quit" 
app:showAsAction="never" 
android:title=" 退 出 "> 
</menu> 


下 面 是 在 页 面 代码 中 操作 溢出 菜单 的 代码 片段 : 


(OOverride 

public boolean onMenuOpened(int featureld, Menu menu) { 
Utils.setOverflowlconVisible(featureld, menu); // 显示 菜单 项 左 侧 的 图 标 
return super.onMenuOpened(featureld, menu); 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.menu overflow, menu); 
return true; 








Android Studio TF 228. 从 零 基础 到 App 上 线 





(@Override 
public boolean onOptionsltemSelected(Menultem item) í 
int id = item.getltemld(); 
if (id == android.R.id.home) { /该 分 支 响应 导航 图 标的 点 击 动作 
finish(); 
} else if (id = R.id.menu refresh) í 
tv_desc.setText(" 当 前 刷新 时 间 : "+Utils.getNowDateTime("yyyy-MM-dd HH:mm:ss")); 
return true; 
} else if (id = R.id.menu about) í 
Toast.makeText(this, "这 个 是 工具 栏 的 演示 demo", Toast.LENGTH. LONG).show(); 
return true; 
} else if (id — R.id.menu quit) { 
finish(); 
h 
return super.onOptionsItemSelected(item); 
} 
添加 溢出 菜单 后 的 导航 栏 效果 如 图 7-11 和 图 7-12 所 示 。 其 中 ， 图 7-11 所 示 为 导航 栏 的 
初始 界面 ， 此 时 导航 栏 右 侧 有 一 个 刷新 按钮 ， 还 有 一 个 三 点 图 标 ; 点 击 三 点 图 标 ， 弹 出 剩余 的 
菜单 项 列表 ， 如 图 7-12 所 示 。 


< 溢出 菜单 页 面 


当前 刷新 时 间 : 2016-10-22 11:23:29 


当前 刷新 时 间 : 2016-10-22 11:2 Q 退出 





图 7-11 溢出 菜单 初始 界面 图 7-12 点 击 按钮 弹出 菜单 列表 
7.23 ”搜索 框 SearchView 


导航 栏 中 间 往 往 有 个 搜索 框 ， 特 别 是 电 商 App 的 导航 栏 ， 搜 索 框 是 标 配 。 在 工具 栏 上 添 
加 并 使 用 搜索 框 有 些 复杂 ， 实 现 步骤 大 致 如 下 : 
CED 在 菜单 布局 文件 中 定义 搜索 项 ， 示 例 代 码 如 下 : 
<item 

android:id="(@+id/menu search" 
android:orderlnCategory="1" 
android:icon="@drawable/ic_search" 
app:showAsAction="ifRoom" 
android:title- "1 zz" 
app:action ViewClass-"android.support.v7.widget.Search View" /> 

E £t resxml 目录 下 新 建 searchable.xml， 设 置 搜索 框 的 样式 代码 ， 举 例如 下 : 


<searchable xmlns:android="http://schemas.android.com/apk/res/android" 
android:label="(@string/app_name" 
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android:hint="(@string/please input" 
android:inputType-"text" 
android:searchButtonText-"(gstring/search" /> 


€I 在 AndroidManifest.xml 中 加 入 一 个 搜索 结果 页 面 的 activity 节点 定义 ， 需 要 指定 action 
和 meta-data， 举 例如 下 : 


<activity android:name=".SearchResultActvity" android:theme="(@style/AppCompatTheme" > 
<intent-filter> 
<action android:name="android.intent.action.SEARCH"/> 
</intent-filter> 
<meta-data android:name="android.app.searchable" android:resource="(@xml/searchable"/> 
</activity> 


E 在 Activity 代码 中 初始 化 搜索 框 ， 并 关联 搜索 动作 对 应 的 结果 Activity, in 
SearchResultActvity。 代 码 片段 如 下 : 





private void initSearchView(Menu menu) í 
Menultem menultem = menu.findltem(R.id.menu_search); 
Search View searchView = (SearchView) MenultemCompat.getAction View(menultem); 
if (searchView — null) í 
Log.d(TAG, "Fail to get Search View."); 
) else í 
if (getIntent() != null) í 
// 设 置 是 否 将 搜索 视图 默认 折 受 为 图 标 
searchView.setIconifiedByDefault(getIntent().getBooleanExtra("collapse", true)); 
) else { 
searchView.setlconifiedByDefault(true); 
l 
/设置 是 否 启 用 完成 图 标 
searchView.setSubmitButtonEnabled(true); 
SearchManager searchManager = (SearchManager) getSystemService(ContextSEARCH 
SERVICE); 
ComponentName cn = new ComponentName(this, SearchResultActvity.class); 
Searchablelnfo info = searchManager.getSearchablelnfo(cn); 
if (info == null) í 
Log.d(TAG, "Fail to get SearchResultActvity."); 
b 
// 设 置 搜索 动作 的 定义 
searchView.setSearchableInfo(info); 
sac key = (SearchView.SearchAutoComplete) searchView.findViewById(R.id.search src text); 
sac key.setTextColor(Color. WHITE); 
sac key.setHintTextColor(Color. WHITE); 
// 设 置 搜索 关键 字 的 监听 器 ， 如 是 否 展示 关键 字 的 匹配 列表 
SearchView.setOnQueryTextListener(new Search View.OnQueryTextListener() í 








Android Studio FERK: 从 零 基 础 到 App _E 





@Override 
public boolean onQueryTextSubmit(String query) { 
return false; 


@Override 

public boolean onQueryTextChange(String newText) { 
doSearch(newText); 
return true; 


» 

Bundle bundle — new Bundle(); 
bundle.putString("hi", "hello"); 

search View.setAppSearchData(bundle); 


private SearchView.SearchAutoComplete sac. key; 
private String[] hintArray = { "iphone", "iphone7s", "iphone7", "iphone7 plus", "iphone6s", "iphone6", 
"iphone6 plus") ; 
private void doSearch(String text) í 
if (text indexOf("i") == 0) í 
ArrayAdapter-String» adapter = new ArrayAdapter-String-(this, 
R.layout.search list auto, hintArray); 
sac key.setAdapter(adapter); 
sac key.setOnItemClickListener(new OnltemClickListener() í 
@Override 
public void onltemClick(AdapterView<?> parent, View view, int position, long id) í 
TextView tv_item = (TextView) view; 
sac key.setText(tv item.getText()); 


H: 


(@Override 

public boolean onCreateOptionsMenu(Menu menu) í 
getMenulnflater().inflate(R.menu.menu search, menu); 
/对 搜索 框 做 初始 化 
initSearchView(menu); 
Teturn true; 
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CIT 编写 搜索 结果 页 面 的 Activity 代码 ， 获 取 关键 字 的 代码 片段 如 下 : 
private void doSearchQuery(Intent intent) { 
if (intent = null) í 
return; 
j else { 
/| 如 果 通 过 ACTION SEARCH 调用 ， 即 通过 搜索 调用 
让 (IntentACTION SEARCH.equals(intent.getAction())) { 
// 获取 额外 信息 
Bundle bundle = intent.getBundleExtra(SearchManager.APP_DATA); 
String value = bundle.getString("hi"); 
/ 获取 搜索 内 容 
String queryString = intent.getStringExtra(SearchManager. QUERY); 
tv_search resultsetText(" 您 输入 的 搜索 文字 是 : "+queryString+", 额外 信息 : "+value); 


j 


搜索 框 的 使 用 效果 如 图 7-13 一 图 7-16 所 示 。 其 中 ,图 7-13 所 示 为 导航 栏 的 初始 界面 ; 图 
7-14 为 点 击 搜索 图 标 后 ， 展 开 搜索 视图 的 界面 ; 图 7-15 所 示 为 输入 搜索 文字 后 ， 弹 出 关键 词 
列表 的 界面 ， 图 7-16 所 示 为 点 击 完成 按钮 ， 跳 转 到 搜索 结果 页 面 的 截图 。 


请 输入 
该 页 面 演示 搜索 框 功能 该 页 面 演示 搜索 框 功能 


图 7-13 ”搜索 框 初始 页 面 图 7-14 展开 搜索 框 的 页 面 





iphone7 





该 页 面 演示 搜 妇 iphone7s 此 输入 的 搜索 文字 是 : iphone7s, 额外 信息 : hello 
iphone7 
iphone7 plus 


图 7-15 输入 关键 字 弹 出 选择 列表 图 7-16 搜索 结果 页 面 的 截图 
7.24 标签 布局 TabLayout 


Toolbar 作为 ActionBar 的 升级 版 ， 好 处 在 于 允许 设置 内 部 控件 的 样式 ， 还 允许 添加 其 他 
外 部 控件 。 第 6 章 的 实战 项 目 “ 手 机 安全 助手 ?流量 主页 面 的 顶部 是 一 个 自己 做 的 简单 导航 栏 ， 
该 导航 栏 的 主 节点 是 LinearLayout， 现 在 我 们 把 LinearLayout 换 成 Toolbar， 相 当 于 系统 默认 
实现 左 侧 的 导航 图 标 和 右 侧 的 溢出 菜单 ， 中 间 的 部 分 是 开发 者 要 添加 的 视图 。 
下 面 是 修改 后 的 布局 文件 片段 ， 此 时 Toolbar 节点 可 以 当 作 LinearLayout 节点 使 用 : 
<android.support.v7.widget.Toolbar 
android:id="@+id/tl_head" 
android:layout width-"match parent" 


:235* 
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android:layout_height="50dp" 
android:background="(@color/blue light" 
app:navigationIcon-"(g)drawable/ic back" > 


«RelativeLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" > 


«TextView 
android:id-"(a)*id/tv day" 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:layout centerInParent-"true" 
android:background-"(g)drawable/editext selector" 
android:gravity-"center" 
android:textColor-"(a)color/black" 
android:textSize-"17sp" /> 


«TextView 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:layout toLeftOf-"(a)*id/tv day" 
android:gravity-"center" 
android:text=" 统 计 日 期 " 
android:textColor="(@color/black" 
android:textSize="17sp" /> 
</RelativeLayout> 
</android.support.v7.widget.Toolbar> 


修改 后 的 导航 栏 效果 如 图 7-17 所 示 ,， 中 部 原来 展 
示 标 题 的 位 置 变 成 展示 统计 日 期 了 。 

如 果 定 制 Toolbar 仅仅 放 入 几 个 基本 控件 ， 就 太 
小 儿科 了 ， 这 么 好 的 工具 栏 ， 必 须 有 杀手 级 别 的 控件 
搭配 。 下 面 先 看 京东 App 的 两 张 截图 , 图 7-18 是 商品 
页 面 ， 图 7-19 是 详情 页 面 ， 这 两 个 页 面 之 间 通 过 左右 滑动 切换 。 导 航 栏 上 有 文字 标签 ， 类 似 
于 翻 页 标题 栏 PagerTabStrip， 用 于 指示 当前 滑 到 了 哪个 页 面 。 

通过 工具 栏 控制 页 面 左 右 滑动 的 用 户 体 验 挺 不 错 ， 这 里 压轴 用 的 便 是 design 库 中 的 标签 
布局 TabLayout， 使 用 该 控件 前 要 先 修改 build.gradle， 在 dependencies 节点 中 加 入 一 行 代码 表 
示 导 入 design 库 : 


compile 'com.android.support:design:25.1.0' 


“Ç "FB 20165108228 Q : 


该 页 面 演示 工具 栏 定制 样式 








7-17 定制 修改 后 的 导航 栏 
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售后 服务 说明 
BRAN Apple 笔记 本 、 台 式 机 无 质量 问题 不 支持 七 天 无 理由 退换 货 ， 
请 您 确认 需求 后 再 灌 活 使 用 ， 











€ MacBook Air 











图 7-18 京东 的 商品 页 面 截图 图 7-19 京东 的 详情 页 面 截图 


TabLayout 的 展现 形式 类 似 于 PagerTabStrip， 同 样 是 文字 标签 带 下 划 线 ， 不 同 的 是 
TabLayout 允许 定制 更 丰富 的 样式 ， 新 增 的 样式 属性 主要 有 以 下 6 种 。 


tabBackground: 指定 标签 的 背景 。 
tabIndicatorColor: 指定 下 划 线 的 颜色 。 
tabIndicatorHeight: 指定 下 划 线 的 高 度 。 
tabTextColor: 指定 标签 文字 的 颜色 。 
tabTextAppearance: 指定 标签 文字 的 风格 。 
tabSelectedTextColor: 指定 选中 文字 的 颜色 。 


下 面 是 在 XML 文件 中 使 用 TabLayout 的 布局 代码 片段 : 


<android.support.v7.widget.Toolbar 
android:id-"(a)*id/tl head" 
android:layout width-"match parent" 
android:layout height-"50dp" 
app:navigationIcon-"(g)drawable/ic back" > 








«RelativeLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" > 


«android.support.design.widget. TabLayout 
android:id-"(g)*id/tab title" 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:layout centerInParent-"true" 
app:tabIndicatorColor-"(g)color/red" 
app:tabIndicatorHeight-"2dp" 
app:tabSelectedTextColor-"(g)color/red" 
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app:tabTextColor="(@color/grey" 
app:tabTextAppearance="(@style/TabText" /> 


</RelativeLayout> 
</android.support.v7.widget.Toolbar> 


在 代码 中 ，TabLayout 通过 以 下 4 种 方法 操作 标签 。 

newTab: 创建 新 标签 。 

addTab: 添加 一 个 标签 。 

getTabAt: 获取 指定 位 置 的 标签 。 
setOnTabSelectedListener: 设置 标签 的 选中 监听 器 .该 监听 器 需 实现 OnTabSelectedListener 
接口 的 3 个 方法 。 

» onTabSelected: 标签 被 选中 时 触发 。 

» onTabUnselected: 标签 被 取消 选中 时 触发 。 

» onTabReselected: 标签 被 重新 选中 时 触发 。 


把 TabLayout 与 ViewPager 结合 起 来 就 是 一 个 固定 的 套路 , 使 用 时 直接 套 框架 就 行 。 下 面 
是 两 者 联合 使 用 的 代码 : 

(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity tab layout); 
tl head = (Toolbar) find ViewById(R.id.tl head); 
tab title = (TabLayout) findViewById(R.id.tab title); 
vp. content = (ViewPager) find ViewById(R.id.vp content); 
setSupportActionBar(tl head); 
mTitleArray.add(" Ë ñ"); 
mTitleArray.add(" 详 情 "); 
initTabLayout(); 
initTabViewPager(); 


private void initTabLayout() í 
tab title.addTab(tab title.newTab().setText(mTitleArray.get(0))); 
tab title.addTab(tab title.newTab().set Text(mTitleArray.get(1))); 
tab title.setOnTabSelectedListener(this); 

} 


private void initTabViewPager() { 
GoodsPagerAdapter adapter = new GoodsPagerAdapter(getSupportFragmentManager(), 


mTitleArray); 


vp content.setAdapter(adapter); 
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vp_content.addOnPageChangeListener(new SimpleOnPageChangeListener() í 
(@Override 
public void onPageSelected(int position) í 
tab title.getTabAt(position).select(); 
} 
» 
i 


@Override 
public void onTabReselected(Tab tab) { 
1 


@Override 
public void onTabSelected(Tab tab) { 
vp_content.setCurrentItem(tab.getPosition()); 


1 


(@Override 
public void onTabUnselected(Tab tab) í 
; 
接 下 来 看 在 工具 栏 上 显示 标签 页 的 效果 。 选 中 “商品 ”标签 ， 页 面 下 方 显示 商品 信息 文 
字 ， 如 图 7-20 所 示 i 选中 “详情 ”标签 ， 切 换 到 商品 详情 页 面 ， 如 图 7-21 所 示 。 感 觉 不 
错 吧 ， 赶 快 动手 实践 一 下 ， 你 也 可 以 实现 京东 App 的 标签 导航 栏 。 










详情 


这 里 是 商品 信息 页 这 里 是 商品 详情 页 





720 点击 “商品 ”标签 图 7-21 点 击 “ 详 情 ” 标 签 
TabLayout 默认 采用 文本 标签 ， 也 支持 自 定义 标签 ， 除 了 放 文 本 还 可 以 放 图 像 ， 比 如 加 一 
个 角 标 。 自 定义 标签 的 过 程 很 简单 ,首先 要 定义 标签 项 的 布局 文件 。 下 面 是 一 个 布局 文件 的 例 
子 ， 其 中 包含 文本 控件 与 图 像 控件 ， 并 且 TextView 的 textColor 属性 与 ImageView 的 sre 属性 
都 采用 状态 图 形 ， 代 码 如 下 : 
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 





android:layout height-"match parent" > 


«TextView 
android:id-"(à)*id/tv toolbarl" 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:layout centerInParent-"true" 
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android:gravity="center" 
android:textColor="(@drawable/toolbar text selector" 
android:textSize-" 1 7sp" /> 


*I[mageView 

android:id-"(g)*id/iv pointl" 
android:layout width-"25dp" 
android:layout height-"25dp" 
android:layout toRightOf-"(z)*id/tv toolbarl" 
android:paddingTop-" 1 0dp" 
android:paddingLeft-"3dp" 
android:scaleType-" fitCenter" 
android:src-"(g)drawable/toolbar image selector" />" 

«/RelativeLayout^ 


然后 打开 活动 页 面 代码 ,只 要 修改 initTabLayout 函数 即 可 , 关键 是 调用 了 setCustomView 
方法 ， 代 码 如 下 : 


private void initTabLayout() í 
tab title.addTab(tab title.newTab().setCustomView(R.layout.item toolbarl)); 
tv toolbar] = (TextView) find ViewById(R.id.tv toolbarl); 
tv toolbarl .setText(mTitleA rray.get(0)); 
tab title.addTab(tab title.newTab().setCustomView(R.layout.item toolbar2)); 
tv toolbar2 = (TextView) find ViewById(R.id.tv toolbar2); 
tv toolbar2.setText(mTitleA rray.get( 1 )); 
tab title.setOnTabSelectedListener(new ViewPagerOnTabSelectedListener(vp content)); 


} 
重新 编译 并 运行 App, 最 新 的 效果 如 图 7-22 和 图 7-23 所 示 。 其 中 , 图 7-22 所 示 为 点 击 “ 商 
品 ” 标 签 时 的 界面 ， 此 时 “商品 ”文字 右上 角 显 示 红 点 ， 图 7-23 所 示 为 点 击 “ 详 情 ” 标 签 时 


的 界面 ， 此 时 “详情 ”文字 右上 和 角 显示 红 点 。 
详情 * Q 


这 里 是 商品 信息 页 这 里 是 商品 详情 页 





图 7-22 点 击 “ 商 品 ”的 自 定义 标签 图 7-23 点 击 “ 详 情 ” 的 自 定义 标签 





73 R 幅 条 


本 节 介 绍 横幅 条 Banner 的 两 种 展现 形式 与 具体 实现 , 包括 如 何在 Banner 底部 自 定义 可 以 
深 动 的 指示 器 、 如 何 实 现 会 自动 轮 播 的 横幅 条 .同时 还 会 复习 自 定义 视图 和 自 定义 动画 的 知识 。 
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7.3.1 自 定 义 指示 器 


在 第 5 章 介 绍 ViewPager 时 给 出 了 启动 引导 页 的 例子 ， 为 了 让 用 户 知 道 当前 是 在 第 几 页 ， 
在 每 个 页 面 下 方 都 要 添加 一 排 圆 点 , 通过 高 亮 圆 点 指示 当前 的 页 面 位 置 , 这 排 圆 点 我 们 称 之 为 
指示 器 。 引 导 页 里 的 指示 器 其 实 附着 在 每 个 Fragment 页 面 下方 ， 而 不 是 固定 在 手机 屏幕 下 方 ， 
所 以 会 感觉 有 些 奇怪 。 理 想 的 情况 是 ， 引 导 页 在 滑动 时 屏幕 下 方 的 指示 器 固定 不 动 ,高 亮 圆 点 
随 着 页 面 滑动 而 缓慢 挪动 ， 页 面 滑 到 下 一 页 ， 高 亮 圆 点 刚好 挪 到 下 一 个 圆 点 处 。 

这 么 说 可 能 有 些 抽 象 ， 不 如 看 看 新 方式 的 效果 图 ， 如 图 7-24 所 示 。 当 前 翻 页 位 置 在 第 一 
页 和 第 二 页 之 前 , 此 时 底部 指示 器 的 高 亮 圆 点 刚好 挪 到 第 一 个 圆 点 与 第 二 个 圆 点 之 问 , 随 着 页 
面 的 滚动 ， 高 亮 圆 点 随 之 平滑 滚动 。 








Group 
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724 底部 滑动 着 的 高 亮 圆 点 


要 实现 指示 器 的 平滑 滚动 效果 , 得 用 到 ViewPager 的 页 面 变化 监听 器 OnPageChangeListener。 
第 5 章 介 绍 该 监听 器 时 提 到 有 onPageScrollStateChanged、onPageScrolled、onPageSelected 三 个 
方法 ， 在 具体 场合 有 下 面 两 种 用 法 。 


1. 只 实现 onPageSelected 方法 ， 在 页 面 滚动 结束 时 触发 ， 该 用 法 是 最 常见 的 。 


在 这 种 情况 下 ,onPageScrollStateChanged 和 onPageScrolled 两 个 方法 成 了 摆设 , 占 着 多 余 
的 代码 行 非常 浪费 。 此 时 不 必 完 整 实现 OnPageChangeListener 接口 ， 只 需 创建 一 个 
SimpleOnPageChangeListener 实例 即 可 ， 该 内 部 类 在 ViewPager 源码 中 已 经 封装 好 了 ， 开 发 者 
只 要 实现 onPageSelected 方法 就 行 。 具 体 的 调用 代码 如 下 : 
mPager.addOnPageChangeListener(new SimpleOnPageChangeListener() { 
(@Override 
public void onPageSelected(int position) í 
setButton(position); 
b 





» 


2. 除了 实现 onPageSelected 方法 ,还 要 实现 onPageScrollStateChanged #0 onPageScrolled 
两 个 方法 。 


这 种 情况 适用 于 指示 器 ， 特 别 是 onPageScrolled 方法 的 参数 已 明确 指出 当前 的 滚动 进度 ， 
正好 给 指示 器 的 滚动 位 置 提供 参考 。 接 下 来 的 工作 是 自 定义 一 个 指示 器 控件 ,首先 绘制 背景 图 
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的 一 排 圆 点 ， 然 后 绘制 前 景 图 的 高 亮 圆 点 。 正 好 复习 一 下 第 6 章 自 定 义 视 图 的 技术 , 读者 可 自 
定义 实现 该 指示 器 控件 ， 下 面 是 该 控件 的 参考 代码 : 
public class PagerIndicator extends LinearLayout í 
private Context mContext; 

















private int mCount = 5; 
private int mPad — 30; 
private int mSeq — 0; 

private float mRatio = 0.0f; 
private Paint mPaint; 

private Bitmap mBackImage; 
private Bitmap mForeImage; 


public PagerIndicator(Context context) í 
this(context, null); 


public PagerIndicator(Context context, AttributeSet attrs) í 
super(context, attrs); 
mContext = context; 
init(); 


private void init() { 
mPaint = new Paint(); 
mBacklImage = BitmapFactory.decodeResource(getResources(), R.drawable.icon point n); 
mForelmage = BitmapFactory.decodeResource(getResources(), R.drawable.icon point c); 


j 
(@Override 
protected void dispatchDraw(Canvas canvas) í 

super.dispatchDraw(canvas); 

int left = (getMeasuredWidth() - mCount*mPad) / 2; 

for (int i-0; i<mCount; i++) í 

canvas.drawBitmap(mBacklImage, left+i*mPad, 0, mPaint); 

; 

canvas.drawBitmap(mForeImage, left-(mSeq*mRatio)*mPad, 0, mPaint); 
; 


public void setCount(int count, int pad) í 
mCount = count; 
mPad = pad; 
invalidate(); 
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} 

public void setCurrent(int seq, float ratio) { 
mSeq = seq; 
mRatio = ratio; 
invalidate(); 


j 


有 了 自 定义 的 指示 器 控件 , 就 可 以 重 写 OnPageChangeListener 接口 的 onPageScrolled 方法 
To 在 该 方法 中 调用 指示 器 的 setCurrent 方法 就 能 动态 刷新 高 亮 圆 点 的 滚动 动画 ， 滚 动 效果 如 
图 7-24 所 示 。 具 体 的 调用 代码 举例 如 下 : 
private class BannerChangeL istener implements ViewPager.OnPageChangeL istener í 
@Override 
public void onPageScrollStateChanged(int arg0) { 
b 





@Override 
public void onPageScrolled(int seq, float ratio, int offset) { 
mindicator.setCurrent(seq, ratio); 


J 


@Override 
public void onPageSelected(int seq) { 
mindicator.setCurrent(seq, 0); 


j 
7.3.2 ”实现 横幅 轮 播 Banner 


前 面 给 ViewPager 加 了 指示 器 , 不 过 仍然 是 静止 页 面 , 只 有 用 户 在 屏幕 上 左右 滑动 时 才 会 
进行 翻 页 动作 。 看 看 电 商 App 的 首页 ， 显 眼 位 置 的 Banner 会 自动 滚动 ， 每 隔 两 三 秒 就 轮 播 下 
-个 广告 页 ， 让 页 面 烟 烟 生 辉 。 不 过 这 难 不 倒 我 们 ， 自 动 滚动 不 就 是 加 一 个 动画 效果 么 ? 第 6 
章 的 自 定义 动画 知识 正好 派 上 用 场 。 只 要 结合 Handler*Runnable, 实现 一 个 简单 动画 非常 容易 。 
下 面 是 自 定义 Banner 的 代码 ， 相 当 于 启动 引导 页 的 代码 加 上 Handler 与 Runnable 组 合 : 
public class BannerPager extends RelativeLayout implements View.OnClickListener { 
private static final String TAG = "BannerPager"; 
private Context mContext; 





private ViewPager mPager; 

private List<ImageView> mViewList = new ArrayList-ImageView^(); 
private RadioGroup mGroup; 

private int mCount; 

private LayoutInflater mInflater; 
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private int dip_15; 
private static int mInterval = 2000; 


public BannerPager(Context context) { 
this(context, null); 


public BannerPager(Context context, AttributeSet attrs) { 
super(context, attrs); 
mContext = context; 
init(); 


public void start() í 
mHandler.postDelayed(mScroll, mlnterval); 


public void stop() í 
mHandler.removeCallbacks(mScroll); 


public void setlnterval(int interval) í 
mlnterval = interval; 


public void setlmage(ArrayList<Integer> imageList) í 

for (int i = 0; i < imageList.size(); i++) { 
Integer imageID = ((Integer) imageList.get(i)).int Value(); 
ImageView iv = new ImageView(mContext); 
iv.setLayoutParams(new LayoutParams( 

LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)); 

iv.setScaleType(ImageView.ScaleType.FIT XY); 
iv.setImageResource(imageID); 
iv.setOnClickListener(this); 
mViewList.add(iv); 

; 

mPager.setAdapter(new ImageA dapater()); 

mPager.addOnPageChangeListener(new SimpleOnPageChangeListener() í 
(a Override 
public void onPageSelected(int position) í 

setButton(position); 


» 
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mCount = imageL ist.size(); 

for (inti = 0; i < mCount; H+) í 
RadioButton radio = new RadioButton(mContext); 
radio.setLayoutParams(new RadioGroup.LayoutParams(dip 15, dip 15)); 
radio.setGravity(Gravity. CENTER); 
radio.setButtonDrawable(R.drawable.indicator selector); 
mGroup.addView(radio); 

$ 

mPager.setCurrentltem(0); 

setButton(0); 


private void setButton(int position) í 
((RadioButton) mGroup.getChildAt(position)).setChecked(true); 


private void init() í 
minflater = ((Activity) mContext).getLayoutInflater(); 
View view = miInflater.inflate(R.layout.banner pager, null); 
mPager = (ViewPager) view.findViewByld(R.id.vp banner); 
mGroup = (RadioGroup) view.find ViewById(R.id.rg indicator); 
addView(view); 
dip 15 = Utils.dip2px(mContext, 15); 


private Handler mHandler = new Handler); 
private Runnable mScroll = new Runnable() í 
@Override 
public void run() { 
scroll ToNext(); 
mHandler.postDelayed(this, mInterval); 


h 


public void scrollToNext() í 
int index = mPager.getCurrentItem() + 1; 
if (mViewList.size() <= index) í 
index = 0; 
} 


mPager.setCurrentItem(index); 





Android Studio 开 烽 实战 :从 零 基础 到 App E 





private class ImageAdapater extends PagerAdapter í 
@Override 
public int getCount() í 
return mViewList.size(); 


@Override 
public boolean isViewFromObject(View arg0, Object arg1) í 
return arg0 = arg1; 


@Override 
public void destroyItem(ViewGroup container, int position, Object object) í 
container.removeView(mViewList.get(position)); 


@Override 

public Object instantiateltem( ViewGroup container, int position) í 
container.add View(mViewList.get(position)); 
return mViewList.get(position); 


@Override 

public void onClick(View v) { 
int position = mPager.getCurrentltem(); 
mListener.onBannerClick(position); 


public void setOnBannerListener(BannerClickListener listener) { 
mListener = listener; 


private BannerClickListener mListener; 
public interface BannerClickListener í 
public void onBannerClick(int position); 


} 
在 Activity 代码 中 使 用 这 个 自 定义 的 Banner 控件 不 难 ， 主 要 是 先 调 用 setImage 方法 设置 
图 片 列表 ， 再 调用 start 方法 启动 轮 播 动画 ， 具 体 代 码 如 下 : 


mBanner = (BannerPager) findViewByld(R.id.banner pager); 
LayoutParams params = (LayoutParams) mBanner.getLayoutParams(); 
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params.height = (int) (DisplayUtil.getSreen Width(this) * 250f/ 640f); 
mBanner.setLayoutParams(params); 

ArrayList<Integer> bannerArray = new ArrayList<Integer>(); 
bannerArray.add(Integer.valueOf(R.drawable.banner 1)); 
bannerArray.add(Integer.valueOf(R.drawable.banner 2)); 
bannerArray.add(Integer.valueOf(R.drawable.banner 3)); 
bannerArray.add(Integer.valueOf(R.drawable.banner 4)); 
bannerArray.add(Integer.valueOf(R.drawable.banner 5)); 
mBanner.setImage(bannerArray); 

mBanner.setOnBannerL istener(this); 

mBanner.start(); 


然后 观察 Banner 轮 播 的 动画 效果 ， 此 时 轮 播 到 第 4 张 图 片 ， 如 图 7-25 所 示 。 轮 播 到 第 5 
张 图 片 的 效果 如 图 7-26 所 示 。 
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74 增强 型 列表 


本 节 介绍 通过 循环 视图 RecyclerView 实现 各 种 增强 型 列表 ， 包 括 线性 列表 布局 、 普 通 网 
格 布局 、 瀑 布 流 网 格 布局 等 ， 并 对 循环 视图 进行 动态 更 新 操作 。 
7.4.1 循环 视图 RecyclerView 

如 果 说 TabLayout 是 导航 栏 一 节 的 压轴 兵器 ， 那 么 循环 视图 RecyclerView 就 是 本 章 的 终 
极 兵 器 , 因为 功能 实在 是 太 强大 了 , 强大 到 秒杀 列表 视图 ListView, 再 秒杀 网 格 视图 GridView， 
还 能 秒杀 瀑布 流 网 格 开源 框架 StaggeredGridView 和 PinterestLikeAdapterView， 总 之 学 会 了 
RecyclerView， 你 的 App 武功 必然 提高 一 个 层次 。 

因为 RecyclerView 是 5.0 之 后 的 新 增 控件 ， 所 以 为 了 兼容 以 前 的 Adnroid 版 本 , 在 使 用 该 
控件 前 要 修改 build.gradle， 在 dependencies 节点 中 加 入 以 下 代码 表示 导入 recyclerview 库 : 

compile 'com.android.support:recyclerview-v7:25.1.0' 


下 面 看 看 强悍 的 循环 视图 提供 的 常用 方法 。 
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setAdapter: 设置 列表 项 的 适配器 。 适 配器 采用 RecyclerView.Adapter。 
setLayoutManager: 设置 列表 项 的 布局 管理 器 , 包括 线性 布局 管理 器 LinearLayoutManager、 
网 格 布局 管理 器 GridLayoutManager、 瀑 布 流 网 格 布局 管理 器 StaggeredGridLayoutManager. 
addItemDecoration: 添加 列表 项 的 分 割 线 。 

removeltemDecoration: 移 除 列表 项 的 分 割 线 。 

setltemAnimator: 设置 列表 项 的 增删 动画 。 默 认 动 画 可 使 用 系统 自 带 的 
DefaultItemAnimator. 

addOnItemTouchListener: 添加 列表 项 的 触摸 监听 器 。 因 为 RecyclerView 没有 实现 列表 项 
的 点 击 接口 ， 所 以 开发 者 可 通过 这 里 的 触摸 监听 器 监控 用 户 手势 。 
removeOnltemTouchListener: 移 除 列表 项 的 触摸 监听 器 。 


RecyclerView 有 专门 的 适配器 类 一 一 RecyclerView.Adapter。 在 调用 RecyclerView 的 setAdapter 
方法 前 ， 得 先 实现 一 个 从 RecyclerView. Adapter 派生 而 来 的 数据 适配器 ， 用 来 定义 列表 项 的 布 
局 与 具体 操作 。 下 面 是 与 RecyclerView.Adapter 相关 的 常用 方法 。 


1. 


自 定义 适配器 必须 要 重 写 的 方法 。 


getltemCount: 获得 列表 项 的 数目 。 

onCreateViewHolder: 创建 整个 布局 的 视图 持 有 者 。 输入 参数 中 包括 视图 类 型 可 根据 视 
图 类 型 加 载 不 同 的 布局 ， 从 而 实现 带头 部 的 列表 布局 。 

onBindViewHolder: 绑 定 每 项 的 视图 持 有 者 。 


. 可 以 重 写 也 可 以 不 重 写 的 方法 。 


getltemViewType: 返回 每 项 的 视图 类 型 。 这 里 返回 的 视图 类 型 供 onCreateViewHolder 77 
法 使 用 。 
getItemld: 获得 每 项 的 编号 。 


. 可 以 直接 调用 的 方法 。 


scrollToPosition: 滚动 到 指定 位 置 。 

notifyItemInserted: 通知 适配器 在 指定 位 置 已 插入 新 项 。 
notifyltemRemoved: 通知 适配器 在 指定 位 置 已 删除 原 有 项 。 
notifyItemChanged: 通知 适配器 在 指定 位 置 的 项 目 已 发 生变 化 。 
notifyDataSetChanged: 通知 适配器 整个 列表 的 数据 已 发 生变 化 。 


下 面 是 RecyclerView.Adapter 一 个 派生 类 的 代码 : 


public class LinearAdapter extends RecyclerView.Adapter<ViewHolder> implements 


OnltemClickListener, OnltemLongClickListener í 
private final static String TAG = "LinearAdapter"; 
private Context mContext; 

private LayoutInflater mlnflater; 

private ArrayList<GoodsInfo> mPublicArray; 
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public LinearAdapter(Context context, ArrayList<GoodsInfo> publicArray) í 
mContext = context; 
minflater = LayoutInflater.from(context); 
mPublicArray = publicArray; 


@Override 
public int getltemCount() í 
return mPublicArray.size(); 


@Override 
public ViewHolder onCreate ViewHolder( ViewGroup vg, int viewType) { 
View v = null; 
ViewHolder holder = null; 
v = mInflater.inflate(R.layout.item linear, vg, false); 
holder = new ItemHolder(v); 
return holder; 


(a Override 
public void onBindViewHolder( ViewHolder vh, final int position) í 
ItemHolder holder — (ItemHolder) vh; 
holder.iv pic.setimageResource(mPublicArray.get(position).pic id); 
holder.tv title.setText(mPublicAr rray.get(position ).title); 
holder.tv desc.setText(mPublicAr rray.get(position).desc); 
/ 列表 项 的 点 击 事件 需要 自己 实现 
holder.ll item.setOnClickListener(new OnClickListener() í 
@Override 
public void onClick(View v) { 
if (mOnltemClickListener != null) í 
mOnltemClickListener.onltemClick(v. position); 


1 
j 
» 
holder.ll item.setOnLongClickListener(new OnLongClickListener() í 
(@Override 


public boolean onLongClick(View v) í 
if (mOnltemLongClickListener != null) í 
mOnltemLongClickListener.onItemLongClick(v, position); 
; 


retum true; 
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» 


(@Override 
public int getItemViewType(int position) í 
// 这 里 返回 每 项 的 类 型 ， 开 发 者 可 自 定义 头 部 类 型 与 一 般 类 型 
// 在 onCreateViewHolder 方法 中 根据 类 型 加 载 的 不 同 布局 ， 从 而 实现 带头 部 的 网 格 布局 


return 0; 


@Override 
public long getltemld(int position) í 
return position; 


public class ItemHolder extends RecyclerView.ViewHolder í 
public LinearLayout ll. item; 
public ImageView iv pic; 
public TextView tv title; 
public TextView tv desc; 


public ItemHolder(View v) í 
super(v); 
ll item = (LinearLayout) v.findViewById(R.id.ll item); 
iv. pic = (ImageView) v.findViewById(R.id.iv pic); 
tv title = (Text View) v.findViewById(R.id.tv title); 
tv. desc = (TextView) v.findViewById(R.id.tv desc); 


j 


private OnItemClickListener mOnItemClickListener; 
public void setOnItemClickListener(OnItemClickListener listener) í 
this.mOnItemClickListener = listener; 


j 


private OnItemLongClickListener mOnItemLongcC lickListener; 
public void setOnItemLongClickListener(OnItemLongClickL istener listener) í 
this.mOnItemLongcClickListener = listener; 


j 


@Override 
public void onItemClick(View view, int position) { 
String desc = String.format(" 您 点 击 了 第 %d 项 ， 标 题 是 %s", position + 1, 
mPublicArray.get(position).title); 
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Toast.makeText(mContext, desc, Toast. LENGTH_SHORT).show(); 
$ 


@Override 
public void onItemLongClick(View view, int position) { 
String desc = String.format(" 您 长 按 了 第 %d 项 ， 标 题 是 %s", position + 1, 
mPublicArray.get(position).title); 
Toast.makeText(mContext, desc, Toast. LENGTH_SHORT).show(); 


ih 
下 面 是 在 活动 页 面 中 操作 循环 视图 及 其 适配器 的 代码 片段 : 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity recycler linear); 
rv. linear = (RecyclerView) findViewById(R.id.rv linear); 
LinearLayoutManager manager = new LinearLayoutManager(this); 
manager.setOrientation(LinearLayout. VERTICAL); 
1v. linear.setLayoutManager(manager); 
LinearAdapter adapter = new LinearAdapter(this, GoodsInfo.getDefaultList()); 
adapter.setOnItemClickListener(adapter); 
adapter.setOnItemLongClickListener(adapter); 
rv. linear.setAdapter(adapter); 
rv. linear.settemAnimator(new DefaultItemAnimator()); 
1v. linear.addItemDecoration(new SpacesItemDecoration( 1 )); 


j 
上 面 的 代码 实现 的 循环 视图 效果 如 图 7-27 所 示 。 这 里 仿照 微 信 公众 号 的 消息 列表 ， 
来 像 是 用 ListView 实现 的 ， 当 然 RecyclerView 的 实际 功能 并 不 仅 限 于 此 。 





Qu. sl. 





图 7-27 循环 视图 的 简单 实现 


看 起 
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742 布局 管理 器 LayoutManager 


布局 管理 器 LayoutManager 是 RecyclerView 的 精髓 ， 也 是 RecyclerView 强悍 的 源泉 。 
LayoutManager 不 但 提供 了 3 类 布局 管理 ， 分 别 实现 类 似 列表 视图 、 网 格 视图 、 瀑 布 流 网 格 的 
效果 , 而 且 可 在 代码 中 随时 由 循环 视图 对 象 调用 setLayoutManager 方法 设置 新 的 布局 。 一旦 调 
用 了 setLayoutManager 方 法 , 界面 就 会 根据 新 布局 刷新 列表 项 。 这 个 特性 特别 适用 于 手机 在 竖 
屏 与 横 屏 之 间 的 显示 切换 (如 竖 屏 时 展示 列表 ， 横 屏 时 展示 网 格 ) ， 也 适用 于 在 不 同 屏幕 分 辩 
K (如 手机 与 平板 ) 之 间 的 显示 切换 〈 如 在 手机 上 展示 列表 ， 在 平板 上 展示 网 格 ) 。 下 面 对 这 
3 类 布局 管理 器 分 别 进行 介绍 。 


1. 线性 布局 管理 器 LinearLayoutManager 


LinearLayoutManager 类 似 于 线性 布局 LinearLayout, 在 简直 方向 布局 时 ， 展 示 效 果 类 似 于 
垂直 的 列表 视图 ListView; 在 水 平方 向 布局 时 ， 展 示 效 果 类 似 于 水 平 的 列表 视图 。 
下 面 是 LinearLayoutManager 的 常用 方法 。 


e 构造 函数 : 可 指定 列表 的 方向 和 是 否 为 相反 方向 开始 布局 。 

e setOrientation :设置 列表 的 方向 ， 可 取 值 LinearLayout.HORIZONTAL 或 LinearLayout. 
VERTICAL. 

e setReverseLayout :设置 是 否 为 相反 方向 开始 布局 ， 默 认 false。 如 果 设 置 为 true, WA E 
直方 向 将 从 下 往 上 开始 布局 ， 水 平方 向 将 从 右 往 左 开始 布局 。 


前 面 在 介绍 循环 视图 时 采用 的 代码 基于 线性 布局 管理 器 ， 具 体 的 效果 如 图 7-27 所 示 。 对 
于 令 人 头疼 的 列表 项 分 隔 线 ，RecyclerView 采取 的 做 法 是 让 开发 者 自 定义 分 隔 线 的 样式 。 下 面 
是 一 个 最 简单 的 分 隔 线 的 实现 ， 允 许 设置 分 隔 线 的 宽度 ， 代 码 如 下 : 
public class SpacesItemDecoration extends RecyclerView.ItemDecoration í 
private int space; 
public SpacesltemDecoration(int space) í 
this.space = space; 
h 




















@Override 
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) { 
outRect.left = space; 
outRect.right = space; 
outRect.bottom = space; 
outRect.top = space; 


lh 
2. 网 格 布局 管理 器 GridLayoutManager 


GridLayoutManager 类 似 于 网 格 布局 GridLayout (该 控件 是 Android4.0 之 后 新 加 的 ) 。 从 
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展示 效果 来 看 ,GridLayoutManager 类 似 于 网 格 视图 GridView。 所 以 , 我们 不 用 关心 GridLayout， 
把 GridLayoutManager 当成 GridView 一 样 使 用 就 好 了 。 
下 面 是 GridLayoutManager 的 常用 方法 。 
e 构造 函数 : 可 指定 网 格 的 列 数 。 
e setSpanCount: 设置 网 格 的 列 数 。 
e setSpanSizeLookup: 设置 列表 项 的 占 位 规则 。 默 认 一 项 占 一 列 ， 如 果 想 某 项 占 多 列 ， 就 
可 以 在 此 设置 自 定义 的 占 位 规则 ， 即 由 GridLayoutManager.SpanSizeLookup 派生 具体 的 


下 面 是 在 活动 页 面 中 操作 网 格 布局 管理 器 的 示例 代码 : 
@Override 


protected void onCreate(Bundle savedInstanceState) í 


j 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity recycler grid); 

1v. grid = (RecyclerView) find ViewById(R.id.rv grid); 
GridLayoutManager manager = new GridLayoutManager(this, 5); 
rv. grid.setLayoutManager(manager); 

GridAdapter adapter = new GridAdapter(this, GoodsInfo.getDefaultGrid()); 
adapter.setOnItemClickListener(adapter); 
adapter.setOnItemLongClickListener(adapter); 

rv. grid.setAdapter(adapter); 

rv. grid.setltemAnimator(new DefaultItemAnimator()); 

rv. grid.addItemDecoration(new SpacesItemDecoration( 1 )); 


网 格 布局 管理 器 的 效果 如 图 7-28 所 示 ， 看 起 来 跟 GridView 的 展示 效果 没什么 区 别 。 
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图 7-28 循环 视图 的 网 格 布局 


但 绝 非 GridView 可 比 , 因为 网 格 布局 管理 器 提供 了 setSpanSizeLookup 方法 , 该 方法 允许 
-个 网 格 占据 多 列 空 间 ， 更 加 灵活 易 用 。 下 面 是 使 用 占 位 规则 的 Activity 代码 片段 : 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


Super.onCreate(savedInstanceState); 
setContentView(R.layoutactivity recycler combine); 

rv. combine = (RecyclerView) find ViewById(R.id.rv combine); 
GridLayoutManager manager = new GridLayoutManager(this, 4); 
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/以 下 占 位 规则 的 意思 是 : 第 一 项 和 第 二 项 占 两 列 ， 其 他 项 占 一 列 
/如 果 网 格 的 列 数 为 4， 那么 第 一 项 和 第 二 项 平分 第 一 行 ， 从 第 二 行 开始 每 行 有 4 项 
manager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() í 
@Override 
public int getSpanSize(int position) { 
if (position = 0 || position=1) { 
return 2; 
} else { 
return 1; 
j 
; 
» 
rv combine.setLayoutManager(manager); 
CombineA dapter adapter = new CombineAdapter(this, GoodsInfo.getDefaultCombine()); 
adapter.setOnItemClickL istener(adapter); 
adapter.setOnItemLongcClickListener(adapter); 
rv. combine.setA dapter(adapter); 
rv combine.setItemAnimator(new DefaultItemAnimator()); 
rv. combine.addItemDecoration(new SpacesItemDecoration(1)); 


} 


使 用 占 位 规则 的 效果 如 图 7-29 所 示 。 可 以 看 到 ， 第 一 行 只 有 两 个 网 格 ， 第 二 行 有 4 个 网 
格 ， 这 意味 着 第 一 行 的 每 个 网 格 都 占据 了 两 列 位 置 。 
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图 7-29 循环 视图 的 合并 网 格 布局 效果 
3. 瀑布 流 网 格 布 局 管理 器 StaggeredGridLayoutManager 
ER App 在 展示 众多 商品 信息 时 ， 往 往 使 用 灵活 高 度 的 格子 展示 。 因 为 不 同 商品 的 外 观 
尺寸 不 一 样 ， 比 如 冰箱 高 高 的 纵向 比较 长 ， 空 调 横 向 比较 长 ， 所 以 若 用 一 样 规格 的 网 格 展示 ， 
必然 有 的 商品 图 片 会 被 压缩 得 很 小 。 这 种 情况 得 根据 不 同 的 商品 形状 展示 不 同 高 度 的 图 片 , 这 
就 是 瀑布 流 网 格 的 应 用 场合 。StaggeredGridLayoutManager 让 瀑布 流 效 果 的 开发 大 大 简化 了 ， 
只 要 在 适配器 中 动态 设置 每 个 网 格 的 高 度 ， 系 统 就 会 自动 在 界面 上 依次 排列 瀑布 流 网 格 。 





组 合 控件 $7X 





下 面 是 StaggeredGridLayoutManager 的 常用 方法 。 


构造 函数 : 可 指定 网 格 的 列 数 和 方向 。 
setSpanCount :设置 网 格 的 列 数 。 
setOrientation :设置 瀑布 流 布局 的 方向 。 取 值 说 明 同 LinearLayoutManager。 
setReverseLayout: 设置 是 否 为 相反 方向 开始 布局 ， 默 认 false。 如 果 设 置 为 tue， 那 么 垂 
直方 向 将 从 下 往 上 开始 布局 ， 水 平方 向 将 从 右 往 左 开始 布局 。 
下 面 是 在 活动 页 面 中 操作 瀑布 流 网 格 布局 管理 器 的 示例 代码 : 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity recycler staggered); 
rv. staggered = (RecyclerView) findViewById(R.id.rv staggered); 
StaggeredGridLayoutManager manager — new StaggeredGridLayoutManager(3, LinearLayout. 


VERTICAL); 
1v. staggered.setLayoutManager(manager); 
StaggeredAdapter adapter = new StaggeredAdapter(this, GoodsInfo.getDefaultStag()); 
adapter.setOnItemClickListener(adapter); 
adapter.setOnItemLongClickListener(adapter); 
rv. staggered.setAdapter(adapter); 
rv. staggered.setItemAnimator(new DefaultItemAnimator()); 
rv. staggered.addItemDecoration(new SpacesItemDecoration(3)); 


j 


瀑布 流 网 格 布局 的 效果 如 图 7-30 与 图 7-31 所 示 , 每 个 网 格 的 高 度 依照 具体 图 片 的 高 度 变 
化 而 变化 ， 整 个 页 面 看 起 来 变 得 生动 活泼 。 读 者 可 以 打开 淘宝 App, 在 项 部 导航 栏 搜索 “ 连 衣 
衬 ”， 看 看 搜索 结果 页 面 是 不 是 如 瀑布 流 网 格 这 般 交 错 显示 ? 














图 7-30 ”循环 视图 的 瀑布 流 效果 1 
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74.3 ”动态 更 新 循环 视图 


循环 视图 之 所 以 成 为 终极 兵器 ， 不 单单 因为 具备 列表 视图 、 网 格 视图 、 瀑 布 流 网 格 三 者 
的 功力 ， 更 是 因为 允许 动态 更 新 内 部 数据 。 不 但 可 以 单独 更 新 某 项 视图 ， 而且 能 够 顺便 展示 增 
删 动画 ， 好 比 刀 光 剑 影 起 落 之 际 还 在 演奏 乐曲 ， 这 才 是 真正 的 无 招 有 性 有 招 。 

下 面 是 在 Acitivity 页 面 中 对 循环 视图 内 部 数据 进行 动态 增 、 删 、 改 的 代码 片段 : 


(@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity recycler dynamic); 
findViewByld(R.id.btn recycler add).setOnClickListener(this); 
rv. dynamic = (RecyclerView) findViewById(R.id.rv dynamic); 
LinearLayoutManager manager = new LinearLayoutManager(this); 
manager.setOrientation(LinearLayout. VERTICAL); 
rv. dynamic.setLayoutManager(manager); 
mAllArray = Goodslnfo.getDefaultList(); 
mPublicArray = GoodsInfo.getDefaultList(); 
mAdapter = new LinearDynamicAdapter(this, mPublicArray ); 
mAdapter.setOnItemC lickListener(this); 
mAdapter.setOnItemLongClickListener(this); 
mAdapter.setOnItemDeleteCllickListener(this ); 
rv. dynamic.setAdapter(m Adapter); 
rv. dynamic.setltemAnimator(new DefaultItemAnimator()); 
rv. dynamic.addItemDecoration(new Spacesltem Decoration(1)); 
j 
@Override 
public void onClick(View v) { 
if (v.getId() = R.id.btn_recycler_add) í 
int position = (int) (Math.random()*100%mAllArray.size()); 
GoodsInfo old item = mAllArray.get(position); 
GoodsInfo new item = new GoodsInfo(old item.pic id, old item.title, old item.desc); 
mPublicArray.add(0, new item); 
mA dapter.notifyItemInserted(0); 
rv. dynamic.scrollToPosition(0); 


j 


@Override 

public void onltemLongClick(View view, int position) í 
GoodsInfo item = mPublicArray.get(position); 
item.bPressed = !item.bPressed; 
mPublicArray.set(position, item); 
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mAdapter.notifyltemChanged(position); 


1 
@Override 


public void onItemClick(View view, int position) í 


String desc = String.format(" 您 点 击 了 第 %d 项 ， 标 题 是 %s", position + 1, 


mPublicArray.get(position).title); 


Toast.makeText(this, desc, Toast. LENGTH_SHORT).show(); 


} 
(QOverride 


public void onItemDeleteClick(View view, int position) { 


mPublicArray.remove(position); 
mA dapter.notifyItemRemoved(position); 


i 


具体 的 演示 效果 如 图 7-32. F8 7-33. A 7-34. K 7-35 所 示 。 其 中 ， 图 7-32 所 示 为 页 面 的 
初始 截图 ， 在 列表 项 部 新 增 一 条 消息 的 截图 ， 消 息 添加 时 其 实 是 有 动画 的 ， 图 7-33 所 示 为 动 
画 结束 之 后 的 界面 ;图 7-34 所 示 为 长 按 某 条 消息 时 的 截图 ， 有 iphone 的 同学 可 以 打开 微 信 ， 
长 按 里 面 的 某 条 聊天 记录 ， 看 看 是 不 是 在 记录 右边 弹出 “删除 该 聊天 ”按钮 ; 点 击 “ 删 除 该 聊 
天 ”会 展示 记录 的 删除 动画 ， 动 画 结束 的 界面 如 图 7-35 所 示 。 





图 7-32 消息 的 初始 页 面 
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图 7-33 新 增 了 一 条 消息 








增加 新 聊天 
北方 周末 
wena 
HH 
北方 周末 


mam 


Qm. 


增加 新 聊天 


北方 周末 
海峡 时 报 
北方 周 未 
Smas, 


OO, 








734 ”长 按 某 条 消息 的 页 面 


图 7-35 删除 该 消息 的 页 面 
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7.5 KRMH: 仿 淘宝 主页 


各 位 亲爱 的 读者 , 经 过 艰苦 的 App 开发 学 习 , 终于 来 到 了 本 节 的 实战 项 目 “ 仿 淘宝 主页 ”。 
淘宝 App 的 主页 动感 十 足 ， 页 面 元 素 丰 富 , SARER, H 7 

中 运用 了 Android 的 多 种 终极 兵器 ， 可 谓 是 App 开发 UI 的 集 
大 成 之 作 。 其 实 到 目前 为 止 ， 本 章 的 知识 点 已 经 涵盖 了 淘宝 主 
页 的 大 部 分 技术 , 所 以 仿照 淘宝 主页 做 一 个 山寨 的 电 商 App Ë 
页 也 不 是 什么 难事 ， 接 下 来 让 我 们 好 好 分 析 一 下 如 何 实现 。 


754 设计 思路 


首先 看 看 大 家 都 熟悉 的 淘宝 主页 长 什么 模样 ， 如 图 7-36 | 22 a sayana 
所 示 。 是 不 是 很 熟悉 呢 ? 其 实 该 页 面 是 各 电 商 App 首页 的 通用 ci bills 

















模板 。 除 了 淘宝 外 ， 还 有 京东 、 苏 宁 易 购 、 当 当 、 美 团 、 百 度 sperm "ua 
粳米 等 ， 这 些 电 商 App 的 主页 都 大 同 小 异 ， 所 以 只 要 吃透 了 淘 e 


宝 主页 采用 的 App HR, IBETI App tB 0848 25 m 8, ie Win. Eam. 
因为 我 们 的 实战 项 目 只 是 仿 淘宝 主页 ， 而 不 是 完全 一 模 一 | 2 

样 ， 所 以 页 面 只 要 大 致 相似 就 行 。 下 面 是 两 张 山寨 后 的 页 面 效 a oo 

果 ， 图 7-37 所 示 为 首页 页 面 的 效果 图 ， 图 7-38 所 示 为 分 类 页 一 一 一 一 一 

面 的 效果 图 。 











"ER 
RE^ — HAT — 先 下 单 AGAR d 
2 a 
图 7-37 WER H 7-38 仿 淘宝 的 分 类 页 面 


数 数 这 两 张 效 果 图 分 别 运 用 了 本 章 的 哪些 知识 点 。 这 两 个 页 面 基 本 上 是 由 前 面 介绍 的 各 
控件 效果 图 拼接 而 成 的 ， 找 起 来 也 不 难 。 


* 258* 
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标签 栏 Tabbar: 页 面 底部 有 一 排 标签 按钮 。 

工具 栏 Toolbar: 页 面 顶部 的 导航 栏 是 工具 栏 Toolbar。 

溢出 菜单 OverflowMenu: 页 面 右上 角 的 三 点 按钮 是 标准 的 溢出 菜单 提示 。 

搜索 框 SearchView: 三 点 按钮 左边 的 放大 镜 按 钮 是 熟悉 的 搜索 图 标 。 

横幅 轮 播 Banner: 导航 栏 下 方 的 广告 图 片 底部 有 指示 器 ， 毫 无 疑问 是 Banner. 

循环 视图 RecyclerView 的 网 格 布局 : Banner 下 方 的 两 排 图 标 是 标准 的 网 格 布局 ， 再 下 面 
的 推荐 栏目 是 合并 网 格 后 的 网 格 布局 。 

标签 布局 TabLayout: 分 类 页 面 顶部 的 “服装 ”和 “电器 ”标签 用 到 了 标签 布局 。 

循环 视图 RecyclerView 的 瀑布 流 布局 : 电器 商品 的 交错 展示 运用 了 瀑布 流 网 格 布局 。 


另外 , 这 个 仿 淘宝 主页 使 用 了 前 几 章 学 过 的 控件 , 包括 翻 页 视图 ViewPager、 碎 片 Fragment 


E 





等 , 正好 一 起 复习 。 同时， 购物 车 页 面 的 具体 处 理 已 经 体现 在 第 4 章 的 实战 项 目 中 了 ， 有 兴趣 


的 读者 可 以 将 其 整合 进来 ， 形 成 一 个 电 商 App 的 完整 demo, 


7.52 


小 知识 : 下 拉 刷 新 SwipeRefreshLayout 


ER App 在 商品 列表 页 面 往往 提供 下 拉 刷 新 功能 ， 把 页 面 整体 下 拉 即 可 触发 页 面 刷新 操 
TÉ. Android 提供 了 下 拉 刷 新 控件 SwipeRefreshLayout， 可 用 于 简单 的 下 拉 刷 新 。 
下 面 是 SwipeRefreshLayout 的 常用 方法 说 明 。 


setOnRefreshListener: 设置 刷新 监听 器 。 需 要 重 写 监听 器 OnRefreshListener 的 onRefresh 
方法 ， 该 方法 在 下 拉 松 开 时 触发 。 

setRefreshing: 设置 刷新 的 状态 。true 表示 正在 刷新 ，false 表示 结束 刷新 。 

isRefreshing: 判断 是 否 正在 刷新 。 

setColorSchemeColors: 设置 进度 圆圈 的 圆 环 颜色 。 
setProgressBackgroundColorSchemeColor: 设置 进度 圆圈 的 背景 颜色 。 
setProgressViewOffset: 设置 进度 圆 图 的 偏 移 量 。 第 一 个 参数 表示 进度 圈 是 否 缩放 ， 第 二 
个 参数 表示 进度 圈 开 始 出 现时 距 顶 端的 偏 黎 ， 第 三 个 参数 表示 进度 图 拉 到 最 大 时 距 顶 端 
的 偏 移 。 

setDistanceToTriggerSync: 设置 手势 向 下 滑动 多 少 距离 才 会 触发 刷新 操作 。 


需要 注意 的 是 ，SwipeRefreshLayout 节点 下 面 只 能 有 一 个 直接 子 视图 。 如 果 有 多 个 直接 子 
视图 , 那么 只 会 展示 第 一 个 子 视图 , 后 面 的 子 视图 将 不 予 展 示 。 这 个 直接 子 视图 必须 允许 滚动 ， 
比如 ScrollView, ListView, GridView, RecyclerView 等 。 如 果 不 是 这 些 视 图 ， 就 不 支持 滚动 ， 
更 不 支持 下 拉 刷 新 。 下 面 是 在 布局 文件 中 使 用 SwipeRefreshLayonut 的 代码 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-" vertical" 
android:padding-" 5dp" > 


«android.support.v4.widget.SwipeRefreshLayout 
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android:id="@+id/srl_ simple" 
android:layout width-"match parent" 
android:layout height-"match parent" > 


<Scroll View 
android:layout width-"match parent" 
android:layout height-"wrap content" > 


«TextView 
android:id-"(2)Fid/tv simple" 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:gravity-"center" 
android:paddingTop-" 1 0dp" 
android:text=" 这 是 一 个 简单 视图 " 
android:textColor="#000000" 
android:textSize-"17sp" > 
</ScrollView> 
</android.support.v4.widget.SwipeRefreshLayout> 
</LinearLayout> 


与 上 面 的 布局 文件 对 应 的 完整 Activity 代码 如 下 : 


public class SwipeRefreshActivity extends AppCompatActivity implements OnRefreshListener { 
private TextView tv_simple; 
private SwipeRefreshLayout srl_simple; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
Super.onCreate(savedInstanceState); 
setContentView(R.layout.activity swipe refresh); 
tv simple = (TextView) findViewById(R.id.tv simple); 
srl simple = (SwipeRefreshLayout) find ViewById(R.id.srl simple); 
srl simple.setOnRefreshL istener(this); 


srl simple.setColorSchemeResources(R.color.red, R.color.orange, R.color.green, R.color.blue); 


(a Override 

public void onRefresh() í 
tv_simple.setText(" 正 在 刷新 "); 
mHandler.postDelayed(mRefresh, 2000); 


private Handler mHandler = new Handler(); 
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private Runnable mRefresh = new Runnable() í 
(@Override 
public void run() í 
tv_simple.setText(" 刷 新 完成 "); 
Srl_simple.setRefreshing(false); 


) 
这 个 简单 下 拉 刷 新 的 效果 如 图 7-39 和 图 7-40 所 示 。 其 中 ， 图 7-39 所 示 为 开始 刷新 时 的 
ARE, E 7-40 所 示 为 结束 刷新 时 的 截图 。 


Group Group 
2 
图 7-39 开始 刷新 时 的 截图 图 740 结束 刷新 时 的 截图 


SwipeRefreshLayout 更 好 的 用 法 是 与 RecyclerView 相 结 合 , 通过 下 拉 刷 新 操作 动态 添加 循 
环视 图 的 记录 ， 从 而 省 去 一 个 添加 按钮 或 刷新 按钮 ， 就 优化 用 户 体验 来 说 ,避免 按钮 太 多 而 显 
得 凌乱 。 下 面 是 在 活动 页 面 中 结合 SwipeRefreshLayout 与 RecyclerView 的 代码 片段 : 


(@Override 
public void onRefresh() í 
mHandler.postDelayed(mRefresh, 2000); 


} 


private Handler mHandler = new Handler(); 
private Runnable mRefresh = new Runnable() í 
@Override 
public void run() { 
srl_dynamic.setRefreshing(false); 
int position = (int) (Math.random() * 100 % mAllArray.size()); 
GoodsInfo old item = mAllArray.get(position); 
GoodsInfo new item = new GoodsInfo(old item.pic id, old item.title, old item.desc); 
mPublicArray.add(0, new item); 
mA dapter.notifyItemInserted(0); 
// 当 循 环视 图 的 列表 项 已 经 占 满 整 个 屏幕 时 ， 再 往 顶 部 添加 一 条 新 记录 ， 感 觉 屏 幕 没 
有 发 生变 化 ， 也 没 看 到 插入 动画 。 此 时 要 调用 scrollToPosition(0) 方 法 ， 表 示 滚 动 到 第 一 条 记录 。 
rv_dynamic.scrollToPosition(0); 
] 
B 


对 循环 视图 进行 下 拉 刷 新 的 效果 如 图 7-41 和 图 7-42 所 示 。 其 中 ， 图 7-41 所 示 为 开始 刷 
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新 时 的 列表 界面 ;图 7-42 所 示 为 结束 刷新 时 的 列表 界面 ， 此 时 列表 顶端 增加 了 一 条 新 记录 。 
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图 741 刷新 中 的 消息 列表 图 7-42 刷新 完成 的 消息 列表 
7.5.8 ”代码 示例 


本 章 的 实战 项 目 用 到 了 TabLayout 与 RecyclerView， 因 为 这 两 个 控件 都 需要 导入 对 应 的 
库 ， 所 以 编码 过 程 与 前 两 章 相 比 多 了 一 步 ， 共 分 为 6 步 。 


ED) 设计 代码 架构 ， 初 步 拆 分 后 的 package 包 ， 包 括 以 下 6 部 分 。 


com.example.department.activity: 存放 Acitivity 页 面 的 代码 。 
com.example.department.adapter: 存放 适配器 的 代码 。 
com.example.department.bean: 存放 实体 数据 结构 的 代码 ， 如 商品 信息 。 
com.example.department.fragment: 存放 碎片 代码 。 
com.example.department.util: 存放 工具 类 代码 。 
com.example.department.widget: 存放 自 定义 控件 的 代码 。 


EI 想 好 代码 文件 与 布局 文件 的 名 称 ， 比 如 App 主页 面 的 代码 文件 取 名 
DepartmentStoreActivityjava， 对 应 的 布局 文件 名 是 activity_department_store.xml， 其 下 有 3 个 子 页 面 ， 
包括 首页 页 面 的 代码 文件 取 名 DepartmentHomeActivityjava ， 对 应 的 布局 文件 名 是 
activity_department_home.xml; 分 类 页 面 的 代码 文件 取 名 DepartmentClassActivityjava， 对 应 的 布局 文 
件 名 是 activity department class.xml; 购物 车 页 面 的 代码 文件 取 名 DepartmentCartActivityjava， 对 应 的 
布局 文件 名 是 activity_department_cart.xml。 

除 此 之 外 ,还 有 搜索 页 面 ucc 搜索 结果 页 面 SearchResultActvity 以 及 碎片 、 适 配 
器 的 代码 及 其 布局 文件 ， 读 者 可 自行 

€I 打开 buildgradle， 在 en 节点 中 加 入 下 面 3 行 代码 ， 表 示 分 别 导 入 
appcompat-v7、design、recyclerview-v7 三 个 库 : 





























compile 'com.android.support:appcompat-v7:25.1.0' 
compile 'com.android.support:design:25.1.0' 
compile 'com.android.support:recyclerview-v7:25.1.0' 


OPES 





组 合 控件 # 73 





€o) 在 AndroidManifestxml 中 补充 相应 配置 ， 主 要 有 以 下 两 点 : 
(1) 注册 两 个 页 面 的 acitivity 节点 ， 注 册 代码 如 下 : 














<activity android:name=".DepartmentStoreActivity" android:theme="(@style/AppCompatTheme" /> 
<activity android:name=".DepartmentHomeActivity" android:theme="(@style/AppCompatTheme" /> 
«activity android:name=".DepartmentClassActivity" android:theme="(@style/AppCompatTheme" /> 
<activity android:name=".DepartmentCartActivity" android:theme="(@style/AppCompatTheme" /> 
<activity android:name=".SearchViewActivity" android:theme="(@style/AppCompatTheme" /> 


(2) 对 SearchResultActvity 单独 配置 ， 注 册 代 码 举 例如 下 : 


<activity android:name=".SearchResultActvity" android:theme="(@style/AppCompatTheme" > 
<intent-filter> 
«action android:name="android.intent.action.SEARCH" > 
</intent-filter> 
<meta-data android:name="android.app.searchable" android:resource="@xml/searchable"/> 
</activity> 
注意 这 里 给 activity 节点 补充 了 AppCompatTheme 风格 ， 目 的 是 声明 不 带 ActionBar 的 风格 ， 以 
{E Activity 代码 内 部 使 用 Toolbar 替换 ActionBar。 


























(1) 在 res/drawable 目录 下 存放 相关 状态 图 形 的 描述 文件 。 

(2) 在 res/layout 目录 下 编写 页 面 、 碎 片 、 适 配器 、 标 签 页 等 对 应 的 布局 文件 。 

(3) 在 res/menu 目录 下 编写 溢出 菜单 的 布局 文件 。 

(4) 在 res/values/styles.xml 中 补充 AppCompatTheme 与 标签 按钮 的 样式 定义 。 

(5) 在 res/xml 目录 下 创建 searchable.xml， 编 写 根 节点 为 searchable 的 搜索 框 样式 定义 。 


EDS 进行 java 代码 开发 ， 包 括 对 页 面 、 碎 片 、 适 配器 等 进行 编码 。 


下 面 是 首页 页 面 DepartmentHomeActivity java 的 完整 代码 : 




















public class DepartmentHomeActivity extends AppCompatActivity implements BannerClickListener í 
private final static String TAG = "DepartmentHomeActivity"; 


(@Override 

protected void onCreate(Bundle savedInstanceState) í 
Super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_department_home); 
Toolbar tl head = (Toolbar) findViewByld(R.id.tl_head); 
tl. head.setTitle(" Ri 9i P$ 91"); 
setSupportActionBar(tl head); 
initBanner(); 
initGrid(); 
initCombine(); 
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private void initBanner() í 
BannerPager banner = (BannerPager) findViewByld(R.id.banner pager); 
LayoutParams params = (LayoutParams) banner.getLayoutParams(); 
params.height = (int) (DisplayUtil.getSreen Width(this) * 250f/ 640f); 
banner.setLayoutParams(params); 
ArrayList<Integer> bannerArray = new ArrayList<Integer>(); 
bannerArray.add(Integer.valueOf(R.drawable.banner 1)); 
bannerArray.add(Integer.valueOf(R.drawable.banner 2)); 
bannerArray.add(Integer.valueOf(R.drawable.banner 3)); 
bannerArray.add(Integer.valueOf(R.drawable.banner 4)); 
bannerArray.add(Integer.valueOf(R.drawable.banner 5)); 
banner.setlImage(bannerArray); 
banner.setOnBannerListener(this); 
banner.start(); 


(a Override 

public void onBannerClick(int position) í 
String desc = String.format(" 您 点 击 了 第 %d 张 图 片 ", position+1); 
Toast.makeText(this, desc, Toas.LENGTH LONG).show(); 


private void initGrid() í 
RecyclerView rv. grid = (RecyclerView) findViewById(R.id.rv grid); 
GridLayoutManager manager = new GridLayoutManager(this, 5); 
rv. grid.setLayoutManager(manager); 
GridAdapter adapter = new GridAdapter(this, GoodsInfo.getDefaultGrid()); 
adapter.setOnItemClickLiistener(adapter); 
adapter.setOnItemLongClickListener(adapter); 
rv. grid.setAdapter(adapter); 
rv. grid.setltemAnimator(new DefaultItemAnimator()); 
rv. grid.addItemDecoration(new SpacesItemDecoration(1)); 


private void initCombine() í 

RecyclerView rv combine = (RecyclerView) findViewById(R.id.rv combine); 
GridLayoutManager manager = new GridLayoutManager(this, 4); 
manager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() í 

(a Override 

public int getSpanSize(int position) í 

if (position = 0 || position—1) í 
return 2; 
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» 

1v combine.setLayoutManager(manager); 

CombineAdapter adapter = new CombineAdapter(this, GoodsInfo.getDefaultCombine()); 
adapter.setOnItemClickListener(adapter); 

adapter.setOnItemLongClickListener(adapter); 

rv combine.setAdapter(adapter); 

rv combine.setltemAnimator(new DefaultItemAnimator()); 

rv combine.addItemDecoration(new SpacesItem Decoration( 1)); 


(@Override 

public boolean onMenuOpened(int featureld, Menu menu) í 
Utils.setOverflowlconVisible(featureld, menu); // 显示 菜单 项 左 侧 的 图 标 
return super.onMenuOpened(featureld, menu); 


(@Override 

public boolean onCreateOptionsMenu(Menu menu) { 
getMenulnflater().inflate(R.menu.menu home, menu); 
return true; 


(@Override 
public boolean onOptionsltemSelected(Menultem item) í 
int id = item.getltemld(); 
if (id == android.R.id.home) í 
finish(); 
) else if (id == R.id.menu search) í 
Intent intent = new Intent(this, Search ViewActivity.class); 
intent.putExtra("collapse", false); 
startActivity(intent); 
} else if (id = R.id.menu refresh) í 
Toast.makeText(this, "当前 刷新 时 间 : "-"Utils.getNowDateTime("yyyy-MM-dd 
HH:mm:ss"), ToasttLENGTH_LONG).show(); 
return true; 
} else if (id = R.id.menu about) í 
Toast.makeText(this, "这 个 是 商城 首页 ", ToasL.LENGTH. LONG).show(): 
return true; 
) else if (id = R.id.menu quit) í 
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finish(); 
; 
return super.onOptionsItemSelected(item); 


7.6 小 2 


本 章 主要 介绍 了 App 开发 的 组 合 控件 相关 知识 , 包括 标签 栏 的 用 法 (标签 按钮 、3 种 标签 
栏 的 实现 方式 ) 、 导 航 栏 的 用 法 〈 工 具 栏 、 溢 出 菜单 、 搜 索 框 、 标 签 布 局 ) 、 横 幅 条 的 用 法 CH 
定义 指示 器 、 横 幅 轮 播 Banner 的 实现 ) 、 增 强 型 列表 的 用 法 循环 视图 、3 种 布局 管理 器 、 
动态 变更 循环 视图 ) 。 最 后 设计 了 一 个 实战 项 目 “ 仿 淘宝 主页 ”， 在 该 项 目的 App 编码 中 采 
用 了 本 章 介 绍 的 大 部 分 组 合 控件 知识 ,并 复习 了 前 几 章 的 相关 技术 。 另 外 , 介绍 了 如 何 使 用 下 
拉 刷 新 控件 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 

(1) 学 会 底部 标签 栏 的 实现 与 用 法 。 

(2) 学 会 顶部 导航 栏 的 实现 与 用 法 。 

(3) 学 会 横幅 轮 播 Banner 的 实现 与 用 法 。 

(4) 学 会 循环 视图 及 其 3 种 布局 管理 器 的 用 法 ， 以 及 通过 下 拉 刷 新 控件 动态 更 新 视图 记录 。 
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CES WwisSEE 


本 章 介 绍 App 从 调试 到 上 线 的 完整 过 程 ， 主 要 包括 利 
用 模拟 器 和 真 机 调试 App、App 在 上 线 前 的 各 种 准备 工作 、 
对 App 安装 包 进 行 安全 加 固 、 把 App 发 布 到 应 用 商店 的 具 
体 步骤 等 。 
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8.1 调试 工作 


本 节 介 绍 几 种 常见 的 App 调试 方法 ， 包 括 使 用 外 置 模拟 器 调试 ， 比 如 几 种 国产 模拟 器 的 
用 法 ; 电脑 连接 真 机 调试 ， 描 述 真 机 调试 要 具备 的 条 件 ; 分 发 APK 安装 包 给 他 人 调试 ， 着 重 
说 明 签名 证 书 的 创建 方法 ， 以 及 如 何 利用 签名 证 书 导出 APK 安装 包 。 


8.1.1 模拟 器 调试 


前 面 几 章 的 App 开发 学 习 基本 采用 了 模拟 器 进行 功能 测试 与 效果 演示 。 在 模拟 器 的 使 用 
过 程 中 ， 不 知道 读者 有 没有 发 现 Android Studio 自 带 的 模拟 器 存在 诸多 不 便 ， 比 如 : 


CD 内 署 模拟 器 启动 速度 慢 ， 资 源 占用 大 。 

(2) 单个 模拟 器 的 屏幕 分 辩 率 是 固定 的 ， 如 果 要 测试 不 同 分 辩 率 ， 就 只 能 另外 创建 新 的 
模拟 器 。 

(3) 内 置 模拟 器 默认 是 竖 屏 显示 ， 无 法 测试 横 屏 的 显示 效果 。 

(4) 内 置 模 拟 器 不 支持 设置 手机 信息 ， 如 手机 品牌 、 型 号 、IMEI 等 。 

(5) 内 署 模拟 器 不 支持 模拟 传感器 功能 ， 如 摇 一 摇 等 。 

(6) 内 置 模 拟 器 不 支持 模拟 定位 。 

从 上 面 可 以 看 出 ， 内 和 模 拟 器 用 于 简单 App 的 测试 还 凑合 ， 如 果 用 于 高 级 测试 场景 就 无 
法 胜任 。 为 了 方便 广大 App 开发 者 ， 各 种 外 置 的 安 卓 模拟 器 如 雨后春笋 般 涌 现 出 来 ， 比 如 国 
外 的 Genymotion 模拟 器 、 各 种 国产 模拟 器 。 这 里 笔者 介绍 两 款 用 得 比较 多 的 国产 模拟 器 一 一 
遂 遥 安 卓 模拟 器 和 夜 神 模拟 器 。 


1. 遂 遥 安 卓 模拟 器 


遂 遥 安 卓 模拟 器 基于 Android4.2.2 (SDK 版 本 19)， 官方 网 站 地 址 是 http://www.xyaz.cn/。 
从 官方 网 站 下 载 安装 文件 ， 下 载 完成 后 双击 即 可 弹出 安装 界面 ， 如 图 8-1 所 示 。 
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选择 模拟 器 的 安装 目录 路 径 ， 然 后 单 击 “安装 ”按钮 ， 等 待 安装 过 程 。 安 装 结束 后 ， 桌 
面 会 出 现 名 为 “逍遥 安 卓 ”的 图 标 ， 双 击 该 图 标 打开 模拟 器 ， 模 拟 器 的 启动 需要 一 定时 间 《〈 几 
十 秒 到 数 分 钟 ， 与 电脑 性 能 有 关 ) 。 耐 心 等 待 模拟 器 启动 完毕 ， 界 面 切 换 到 模拟 器 的 仿 手机 界 
MEK, WE 8-2 所 示 。 









82 省 遥 安 卓 的 横 屏 桌 面 


遂 遥 安 卓 默认 展示 横 屏 ， 若 想 切换 到 紧 屏 显示 ， 则 单 击 模拟 器 主 界面 右 侧 一 列 图 标的 第 5 
个 或 第 6 个 “旋转 屏幕 ”图 标 ， 即 可 进行 横竖 屏 切 换 ， 切 换 后 的 竖 屏 界面 如 图 8-3 所 示 。 

右 侧 图 标 列 除了 “旋转 屏幕 ”外 ， 还 有 截图 、 摇 一 摇 、 屏 幕 录制 、 设 置 (齿轮 图 标 )、 
音量 控制 等 图 标 。 单 击 齿轮 图 标 打开 设置 窗口 ， 在 “常用 ”页 面 可 设置 CPU 个 数 、 内 存 大 小 、 
分 辩 率 等 信息 ， 在 “高 级 ”页 面 可 设置 手机 品牌 、 手 机 型 号 、IMEI 串 号 等 信息 ， 如 图 8-4 所 
示 。 设 置 修改 完毕 后 ， 单 击 窗口 下 方 的 “保存 ”按钮 ， 新 设置 在 下 次 启动 模拟 器 后 生效 。 
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遂 遥 安 卓 主 界面 右 下 角 还 有 一 列 〈 共 4 个 图 标 ) ， 从 上 往 下 依次 表示 后 退 键 、 桌 面 键 、 
任务 键 、 菜 单 键 。 多 数 手 机 的 下 方 只 有 三 个 按键 ， 从 左 往 右 分 别 是 菜单 键 、 桌 面 键 、 后 退 键 ， 
长 按 桌 面 键 会 弹出 任务 列表 (近期 有 运行 的 App 列表 ) ， 有 的 手机 取消 菜单 键 换 成 任务 键 ， 
道 遥 安 卓 提供 4 个 按钮 模拟 这 4 种 按键 操作 。 

利用 遂 遥 安 卓 调试 App 的 过 程 与 内 置 模拟 器 类 似 ， 开 发 者 先 启动 Android Studio， 等 待 启 
动 完成 后 再 双击 启动 道 遥 安 卓 。 等 待 道 遥 安 卓 启动 完成 进入 桌面 后 ， 在 Android Studio 上 依次 
选择 菜单 Run— Run ****， 这 时 弹出 设备 选择 窗口 ， 如 图 8-5 所 示 。 

该 窗口 中 的 Samsung GT-P52100 (Android 4.22, API 17) 为 道 遥 安 卓 模拟 器 ， 单 击 窗口 下 
方 的 OK 按钮 ， 等 待 Android Studio 编译 并 将 App 安装 到 遂 遥 安 卓 ， 后 续 的 App 调试 操作 就 
可 以 在 模拟 器 上 执行 了 。 

2. 夜 神 模拟 器 


夜 神 模拟 器 基于 Android4.4.2 (SDK 版 本 17) ， 官 方 网 站 地 址 是 http:Wwww.yeshen.comy/。 
从 官方 网 站 下 载 安装 文件 ， 下 载 完 成 后 双击 打开 ， 弹 出 安装 界面 如 图 8-6 所 示 。 


nox 
Š 
f° Select Deployment Target s = e] 
Connected Devices * 
| Samsung GT-P52100 (Android 4.2.2, API 17) 


快速 安装 











| Create Jew Enulator Don't see your device? 





| DD Use sane selection for future launches = pwu 


图 8-5 启动 App IFBB ZFR 图 8-6 夜 神 模拟 器 的 安装 界面 
单 击 “ 快 速 安装 ”按钮 或 右 下 角 的 “ 自 定 义 安装 ”对 安装 路 径 进行 设置 。 在 安装 过 程 中 ， 
系统 可 能 会 弹出 对 话 框 提 示 是 否 安装 设备 软件 ， 提 示 对 话 框 如 图 8-7 所 示 。 
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| 您 想 安装 这 个 设备 软件 吗 ? 


fx: Oracle Corporation 通用 串 行 总 线 控制 器 
| Ø ËF: Duodian Online Technology Co. Ltd 
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图 8-7 安装 设备 软件 的 提示 对 话 框 
在 该 对 话 框 单 击 “ 安 装 ” 按 钮 ， 等 待 安装 过 程 。 安 装 结束 后 ， 桌 面 会 出 现 名 为 “ 夜 神 模 
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拟 器 ”的 图 标 ， 双 击 该 图 标 打开 模拟 器 ， 模 拟 器 的 启动 需要 一 定时 间 。 耐 心 等 待 模拟 器 启动 完 
毕 ， 界 面 切换 到 模拟 器 的 仿 手机 界面 主页 ， 如 图 8-8 所 示 。 





图 8-8 ” 夜 神 模拟 器 的 横 屏 桌面 
夜 神 默认 展示 竖 屏 还 是 横 屏 与 设置 有 关 ， 在 界面 右上 角 的 中 央 找 到 一 个 齿轮 图 标 ， 这 是 
模拟 器 的 设置 入 口 ， 单 击 该 图 标 弹出 设置 窗口 ， 如 图 8-9 所 示 。 





图 8-9 夜 神 模拟 器 的 设置 界面 


在 设置 窗口 的 左边 菜单 列表 中 单 击 “高 级 菜单 ”选项 ， 窗 口 右边 就 切换 到 高 级 设置 页 面 。 
这 里 可 以 设置 模拟 的 CPU 个 数 、 内 存 大 小 ， 还 可 设置 默认 显示 横 屏 (平板 版 ) 还 是 竖 屏 CF 
机 版 ) ， 以 及 模拟 界面 的 屏幕 分 辩 率 。 设 置 修改 完成 后 ， 单 击 窗口 下 方 的 “保存 设置 ”按钮 ， 
下 次 启动 模拟 器 时 就 会 生效 最 新 的 设置 。 

夜 神 模拟 器 主 界面 右边 是 一 列 图 标 按钮 ， 用 于 一 些 特殊 功能 的 快捷 操作 ， 包 括 摇 一 摇 、 
屏幕 截图 、 虚 拟定 位 、 音 量 控制 、 视 频 录 制 等 ， 开 发 者 可 在 具体 的 功能 测试 时 加 以 控制 。 主 界 
面 右 下 角 有 3 个 控制 图 标 ， 从 上 往 下 依次 表示 返回 键 、 主 页 键 、 任 务 键 〈 提 示 菜 单 键 ， 其 实 是 
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任务 键 ) 。 这 里 找 不 到 可 用 的 菜单 键 是 不 是 很 奇怪 ? 其 实 夜 神 模 拟 器 的 菜单 键 需要 电脑 键盘 输 
入 ， 电 脑 键盘 右 下 方 的 Alt 键 与 Ctrl 键 之 间 有 一 个 “一 口 三 横 ” 键 (菜单 键 ) ， 按 电脑 键盘 的 
菜单 键 相当 于 模拟 器 的 菜单 键 点 击 操作 。 

利用 夜 神 模拟 器 调试 App 的 过 程 与 道 遥 安 卓 类 似 ， 开 发 者 先 启动 Android Studio， 再 启动 
夜 神 模拟 器 ， 等 待 夜 神 启 动 完毕 进入 桌面 后 ， 回 到 Android Studio 选择 菜单 Run Run ***'。 
此 时 弹出 的 设备 选择 窗口 如 图 8-10 所 示 。 
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图 8-10 JAZ) App 时 发 现 夜 神 模拟 器 


该 窗口 中 的 Bigsamsung Nexus (Android 4.4.2, API 19) 为 夜 神 模拟 器 ， 单 击 窗口 下 方 的 
OK 按钮 ， 等 待 Android Studio 将 App 安装 到 夜 神 ， 后 续 即 可 在 模拟 器 上 调试 。 


84.2 真 机 调试 


外 置 模拟 器 即使 做 得 再 好 ， 对 很 多 功能 的 调试 也 力 有 不 建 ， 毕 竞 没 法 完全 模拟 真实 手机 ， 
若 有 可 能 ， 还 是 尽量 使 用 真 机 进行 测试 。 利 用 真 机 调试 要 具备 以 下 4 个 条 件 : 


1. 需要 使 用 数据 线 把 手机 连 到 电脑 上 。 


手机 的 电源 线 拔 掉 插 头 就 是 数据 线 。 数 据 线 长 方形 的 一 端 接 到 电脑 的 USB 口上 ， 即 可 完 
成 手机 与 电脑 的 连接 。 


2. 要 在 电脑 上 安装 手机 的 驱动 程序 。 


- 般 电脑 会 把 手机 当 作 USB 存储 设备 一 样 安装 驱动 ， 大 多 数 情况 会 自动 安装 成 功 。 如 果 

遇 到 少数 情况 安装 失败 ， 就 可 以 先 安装 91 手机 助手 ， 自 动 下 载 并 安装 对 应 的 手机 驱动 。 

3. 要 在 手机 上 启用 USB 调试 功能 。 

手机 连接 电脑 后 ， 下 拉 通 知 栏 通常 会 有 “USB 计算 机 连接 ”选项 ， 点 击 该 选项 跳 到 USB 
连接 页 面 。 勾 选 该 页 面 上 的 “USB 调试 ”选项 开启 USB 调试 功能 ， 如 图 8-11 所 示 。 

USB 调试 功能 开启 后 ， 每 次 拿手 机 连接 电脑 ， 屏 幕 上 都 会 弹出 对 话 框 “允许 USB 调试 
吗 ? ”， 如 图 8-12 所 示 。 勾 选 该 对 话 框 上 的 “一 律 允 许 使 用 这 台 计 算 机 进行 调试 ”， 然 后 点 
击 “ 确 定 ”按钮 ， 该 手机 就 具备 了 App 调试 条 件 。 
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< USB 计算 机 连接 
连接 方式 允许 USB 调试 吗 ? 
设备 (M 
MK dows XPRELTEERSE 这 台 计 算 机 的 RSA 密 钥 指 纹 如 下 : 
M^ 96:6B:73:33:C3:A9:F1:6D:D1:4A:0D: 





相机 (PTP) 69:9A:8F:B4:DE 


连接 计算 机 传输 央 片 














USB 存储 设备 (SD +) 允许 使 用 这 台 并 行 调试 
ë axe Q 一 律 区 许 使 用 这 台 计算 机 进行 调 记 








USB 调试 


连接 USB 后 启用 网 坛 模式 











图 8-11 USB 计算 机 连接 页 面 图 8-12 USB 调试 的 提示 对 话 框 

USB 调试 功能 可 在 设置 中 通过 “系统 ”一 “开发 者 选 
项 ” (有 的 手机 在 “系统 ”一 “更 多 设置 ”一 “开发 者 选 
项 ”) 找到 ， 勾 选 该 功能 开启 USB 调试 ， 如 图 8-13 所 示 。 

现在 很 多 手机 默认 没有 “开发 者 选项 ”这 个 菜单 ， 即 
使 把 手机 连接 到 电脑 ， 仍 然 无 法 找到 “开发 者 选项 ”， 更 
别提 USB 调试 了 。 此 时 要 进入 “系统 ”一 “关于 手机 ”一 
“版 本 信息 ”页 面 ， 这 里 有 好 几 个 版 本 项 ， 每 个 版 本 项 都 图 8-13 ”开发 者 选项 页 面 
使 劲 点 击 七 、 八 下 ， 总 会 有 某 个 版 本 点 击 后 出 现 “你 将 开 
启 开发 者 模式 ”的 提示 。 继 续 点 击 该 版 本 项 开启 开发 者 模式 ， 然 后 退出 并 重新 进入 设置 页 面 ， 
此 时 就 能 在 “系统 ”菜单 下 找到 “开发 者 选项 ”了 。 


4. 手机 要 处 于 使 用 状态 ， 即 不 能 锁 屏 。 


锁 屏 状态 下 ，Android Studio 向 手机 安装 App 的 行为 会 被 拦截 ， 所 以 要 保证 手机 处 于 解锁 
状态 ， 才 能 顺利 通过 开发 电脑 安装 App 到 手机 上 。 

经 过 以 上 步骤 , 总 算 具 备 通过 电脑 在 手机 上 安装 App 的 条 件 了 。 马上 启动 Android Studio, 
依次 选择 菜单 Run 一 Run ***'， 在 弹出 的 设备 选择 窗口 可 以 看 到 已 连接 的 手机 信息 ， 如 图 8-14 
所 示 。 此 时 的 设备 信息 提示 这 是 一 台 小 米 手机 ， 单 击 窗口 下 方 的 OK 按钮 ， 接 下 来 的 事情 就 是 
等 待 Android Studio 往 手 机 上 安装 App 了 。 
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| Create New Enulator Dor’ t see your device? || 


[ J se sare selection for future launches E 
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图 8-14 JAZ) App 时 发 现 真实 的 手机 
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8.1.3 导出 APK 安装 包 


前 面 说 的 真 机 调试 是 通过 数据 线 把 手机 连 到 电脑 上 ， 不 过 在 公司 的 App 开发 工作 中 ， 一 
个 App 要 在 多 部 测试 手机 上 安装 ， 难 道 每 次 都 得 把 手机 拿 到 手 才 能 安装 App 吗 ? 这 么 做 显然 
很 不 方便 ， 此 时 可 以 把 App 打包 成 一 个 APK 文件 (该 文件 就 是 App 的 安装 包 )， 然 后 把 APK 
传 给 测试 人 员 进行 后 续 调试 工作 。 在 Android Studio 中 打包 APK， 具 体 步 又 如 下 : 


(KI. 依次 选择 菜单 Build 一 Generate Signed APK...， 弹 出 窗口 如 图 8-15 所 示 。 


EI 在 该 窗口 中 选择 待 打包 的 模块 名 (如 test) ， 单 击 Next 按 钮 ， 进 入 APK 签名 窗口 页 面 ， 
如 图 8-16 所 示 。 
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图 8-15 ”生成 安装 包 的 窗口 页 面 图 8-16 APK 签名 的 窗口 页 面 


E 在 该 窗口 选择 密 钥 文件 的 路 径 ， 如 果 原 来 有 密 钥 文件 ， 就 单 击 Choose existing... 按 钮 ， 
在 弹出 的 文件 对 话 框 中 选择 密 钥 文件 。 如 果 第 一 次 打包 没有 密 钥 文件 ， 就 单 击 Create new... 按 钮 ， 然 
后 弹出 一 个 密 钥 创建 窗口 ， 如 图 8-17 所 示 。 


CELL 单 击 该 窗口 右上 角 的 辐 按 钮 ， 选 择 密 钥 文件 的 保存 路 径 ， 单 击 按钮 后 弹出 文件 对 话 框 ， 
如 图 8-18 所 示 。 



































Te Goose keystore file] 1o = 
| save as =. ks 
š — A | | 
isev Key Sto =. — [sme x 9 ü Kide path 
Key store path: [| L-J F: StudioProjects HelleVerld test Ë 
r Eiieis 
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Altas: 
Password: | consira: | 
Haltaity (years): [ 28] 





Certificate 
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Organizational Unit: | 








Organization: 








City or Locality: 








State or Provlnce: 








Country Code (QD: | 
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图 8-17 密 钥 文件 的 生成 窗口 图 8-18 ” 密 钥 文件 的 文件 对 话 框 
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E 在 文件 对 话 框 中 选择 文件 保存 路 径 ， 并 在 下 方 File name 右边 输入 密 钥 文件 的 名 称 ， 然 
后 单 击 OK 按钮 回 到 密 钥 创建 窗口 。 在 该 窗口 依次 填写 密码 Password、 确 认 密码 Confirm、 别名 Alias, 
别名 密码 Password、 别 名 的 确认 密码 Confirm， 修 改 密 钥 文件 的 有 效 期 限 Validity。 下 面 的 输入 框 只 
姓名 (First and Last Name) 是 必 填 的 ， 填 完 后 的 窗口 如 图 8-19 所 示 。 

€X06 单 击 OK 按钮 回 到 APK 签名 窗口 ， 此 时 Android Studio 自动 把 密码 和 别名 都 十 上 了 ， 
如 图 8-20 所 示 。 如 果 一 开始 选择 已 存在 的 密 钥 文件 ， 这 里 就 要 手工 输入 密码 和 别名 。 




























































































ET =. 
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State or Province: Key passyord; — eee | 
| 
Pays ouem aa mE | [ J Reaeaber passwords 
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图 8-19 填写 完成 的 密 钥 创 建 窗口 图 8-20 填 上 签名 信息 的 签名 窗口 


E £d Next 按钮 进入 下 一 个 页 面 ， 如 果 是 启动 后 第 一 次 打包 ， 就 会 弹出 管理 员 密码 确认 
窗口 ， 如 图 8-21 所 示 。 输 入 密码 再 单 击 OK 按钮 进入 APK 保存 页 面 ， 如 图 8-22 所 示 。 如 果 不 是 第 一 
次 打包 ， 就 直接 进入 Apk 保存 页 面 。 





— — — 
fh Generate Signed APK "P Lad 





Note: Proguaré settings are specified using the Project Structure Dialog 
Enter Master Pascrori WW 2M L... APK Destination Folder: |F:\StudioProjects\HelloWorld\test CJ 














Elavors: 
Master password is required to unlock the password database. rs defined | 

a password database will be unlocked during this session 
| for all subsystems. | | 


Requested by: Kevetcre Step 




















l Le | 0000 1 Previous Cancel Help | 


图 8-21 管理 员 密 码 确认 窗口 822 APK 保存 页 面 


APK 保存 页 面 可 选择 APK 文件 的 保存 路 径 和 编译 类 型 (Build Type) ， 如 果 用 于 调试 ， 
编译 类 型 就 选择 debug: 如 果 用 于 发 布 , 编译 类 型 就 选择 release。 单 击 Finish 按钮 ,等待 Android 
Studio 生成 APK 。 

如 果 没 有 编译 问题 , 过 一 会 儿 就 会 在 APK 保存 路 径 下 看 到 名 为 test-debug.apk 的 文件 , 把 
该 安装 包 传 给 其 他 人 ,让 其 他 人 用 数据 线 把 该 文件 复制 到 手机 的 SD 卡 上 , 然后 打开 手机 的 文 
件 管理 器 ， 找 到 这 个 安装 包 进行 安装 。 
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82 准备 上 线 


本 节 介 绍 App 上 线 前 必须 做 的 准备 工作 ， 包 括 正 确 设置 版 本 信息 ， 例 如 设置 App 图 标 、App 
名 称 、App 版 本 号 ; 把 开发 模式 切换 到 上 线 模式 , 除了 代码 的 切换 外 , 还 需 修改 AndroidManifestxml; 
对 关键 业务 数据 进行 加 密 处 理 ， 加 密 算法 主要 有 MD5、RSA、AES、3DES 等 。 


8.2.1 版 本 设置 


迄今 为 止 , 本 书 所 有 演示 App 在 屏幕 上 都 显示 默认 的 机 器 人 图 标 , 不 过 推出 一 个 正式 App 
需要 用 自己 设计 的 图 标 ， 而 且 App 名 称 要 把 英文 名 换 成 中 文 名 。App 安装 后 需要 经 常 升级 ， 
所 以 少不了 版 本 号 的 管理 。 开 发 一 个 正式 App 需要 定制 3 类 版 本 信息 ， 分 别 是 App 图 标 、 App 
名 称 和 App 版 本 号 。 


1.App 图 标 


App 图 标 文 件 是 res/mipmap-*** 目 录 下 的 ic_launcher.png。 若 要 更 改 手机 桌面 上 的 应 用 图 
标 ， 则 要 把 mipmap-*** 目 录 下 的 ic_launcherpng 换 成 新 图 标 。 


2.App 名 称 


App 名 称 保存 在 res/values/strings.xml 的 app name 中 。 若 要 更 改 手机 桌面 上 的 应 用 名 称 ， 
则 要 把 strings.xml 的 app name 改 成 新 名 称 。 


3. App 版 本 号 


App 版 本 号 放 在 build.gradle 的 versionCode 与 versionName 两 个 参数 中 。versionCode 必须 
为 整 型 值 ， 每 次 升级 版 本 时 值 都 要 加 1。versionName 形 如 “数字 .数字 .数字 ”， 第 一 个 数字 为 
大 版 本 号 ， 有 重要 功能 升级 时 ， 大 版 本 号 要 加 1， 后 面 两 个 数字 清 零 ; 第 二 个 数字 为 中 版 本 号 ， 
每 次 要 进行 功能 更 新 时 ， 中 版 本 号 加 1， 第 三 个 数字 清 零 ; 第 三 个 数字 为 小 版 本 号 ， 在 有 问题 
修复 与 界面 微调 时 ， 小 版 本 号 加 1。 
注意 每 次 App 升级 ，versionCode 与 versionName 都 要 一 起 更 改 ， 不 能 只 改 其 中 一 个 。 升 
级 后 的 versionCode 与 versionName 只 能 比 原 来 大 ， 不 能 比 原来 小 。 如 果 没 有 按照 规范 修改 版 
本 号 ， 就 会 产生 以 下 问题 : 
(1) 版 本 号 比 已 安装 的 版 本 号 小 ， 在 安装 时 直接 提示 失败 ， 因 为 App 只 能 做 升级 操作 ， 
不 能 做 降级 操作 。 
(2) 更 新 系统 内 置 应 用 时 ， 如 果 只 修改 versionName， 没 修改 versionCode， 重 启 手机 后 
就 会 发 现 更 新 丢失 ,该 系统 应 用 已 被 还 原 到 更 新 前 的 版 本 。 这 是 因为 Android 内 核 在 判断 系统 
应 用 时 会 检查 versionCode 的 数值 ， 如 果 versionCode 不 大 于 当前 已 安装 的 版 本 号 ， 本 次 更 新 
就 被 忽略 。 
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下 面 是 获取 App 版 本 信息 的 代码 片段 : 


@Override 
protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity version); 
ImageView iv icon = (ImageView) find ViewById(R.id.iv icon); 
TextView tv desc = (TextView) findViewById(R.id.tv desc); 
iv icon.setImageResource(R.mipmap.ic launcher); 
try ( 
Packagelnfo pi = getPackageManager().getPackageInfo(getPackageName(), 0); 
String desc = String.format(" App 名 称 为 : %smApp 版 本 号 为 : %dmApp 版 本 名 称 为 : os", 
getResources().getString(R.string.app name), pi.versionCode, pi.versionName); 
tv desc.setText(desc); 
} catch (NameNotFoundException e) í 
e.printStackTrace(); 
h 
| 


App 版 本 信息 的 获取 页 面 如 图 8-23 所 示 ， 分 别 展示 了 测 
试 App 的 应 用 图 标 、 应 用 名 称 、 应 用 的 版 本 号 以 及 版 本 名 称 。 


822 ”上 线 模式 App 图 标 为 : -— 


App 名 称 为 : Test 
为 了 开发 调试 方便 , 程序 员 常 常 在 代码 里 添加 日 志 , 还 在 App 版 本 号 为 ; 1 





App 版 本 名 称 为 : 1.0 
页 面 上 提示 各 种 弹 窗 。 这 样 固然 有 利于 发 现 bug、 提 高 软件 质 PP 


BL, 不 过 调试 信息 过 多 往往 容易 泄露 敏感 信息 , 例如 用 户 的 账 ”图 8-23 App 版 本 信息 的 获取 页 面 
号 密码 、 业 务 流程 的 逻辑 等 。 从 保密 需要 考虑 ，App 在 上 线 前 需要 去 掉 多 余 的 调试 信息 ， 形 成 
上 线 模式 。 与 之 相对 的 是 开发 阶段 的 开发 模式 。 

建立 上 线 模式 的 好 处 有 以 下 3 点 : 


CD. 保护 用 户 的 敏感 账户 信息 不 被 泄露 。 
(2) 保护 业务 逻辑 与 流程 处 理 信息 不 被 泄露 。 
(3) 把 异常 信息 转换 为 更 友好 的 提示 信息 ， 改 善 用 户 体验 。 


上 线 模式 不 是 简单 的 把 调试 代码 删 掉 ， 而 是 通过 某 个 开关 控制 是 否 显 示 调 试 信息 ， 因 为 
App 后 续 还 得 修改 、 更 新 、 重 新 发 布 ， 这 个 迭代 过 程 要 不 断 调 试 ， 从 而 实现 并 验证 新 功能 。 具 
体 地 说 , 就 是 建立 几 个 公共 类 , 代码 中 涉及 输入 调试 信息 的 地 方 都 改 为 调用 公共 类 的 方法 ; 然 
后 在 公共 类 中 定义 几 个 布尔 变量 作为 开关 , 在 开发 时 打开 调试 , 在 上 线 时 关闭 调试 ， 从 而 实现 
开发 横 式 和 上 线 模式 的 切换 。 

控制 调试 信息 的 公共 类 主要 有 3 种 ， 分 别 对 Log 类 、Toast 类 和 AlertDialog 类 进行 封装 ， 
详细 说 明 如 下 : 





Android Studio Tr # 2: 


1. Log 


Log 类 用 于 打印 调试 日 志 。 调 试 App 时 ， 日 志 信息 会 输出 到 控制 台 console 窗口 。 因 为 最 
终 用 户 看 不 到 App 日 志 ， 所 以 除非 特殊 情况 ， 发 布 上 线 的 App 应 屏蔽 所 有 日 志 信息 。 
下 面 是 日 志 工具 类 的 代码 : 
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2. Toast 


Toast 类 用 于 在 界面 下 方 弹出 小 窗 , 给 用 户 一 两 句 话 的 提示 , 小 窗 短暂 停留 一 会 儿 后 消失 。 
Toast 窗口 无 交互 动作 ， 样 式 也 基本 固定 ， 因 此 除了 少数 弹 窗 可 予以 保留 (如 “再 按 一 次 返回 
键 退 出 ”) ， 其 他 弹 窗 都 应 在 发 布 时 屏蔽 。 

下 面 是 提示 工具 类 的 代码 : 

public class ToastTool í 

public static boolean isShow = false; // false 表示 上 线 模式 ，true 表示 开发 模式 





public static void showShort(Context ctx, String msg) í 
if (isShow — true) í 
Toast.makeText(ctx, msg, Toast.LENGTH_SHORT).show(); 
D 
1 


public static void showLong(Context ctx, String msg) í 
if (isShow = true) í 
Toast.makeText(ctx, msg, Toast.LENGTH_LONG).show(); 
J 
h 


public static void showQuit(Context ctx) í 
Toast.makeText(ctx, "再 按 一 次 返回 键 退出 ! ", Toast.LENGTH_SHORT).show(); 
; 
} 


3. AlertDialog 


提醒 对 话 框 常用 于 各 种 与 用 户 交互 的 操作 ， 如 果 是 业务 逻辑 需要 ， 该 对 话 框 就 无 须 区 分 
不 同 模式 ， 如 果 是 提示 错误 信息 ， 对 话 框 就 应 该 针对 两 种 模式 做 不 同 处 理 。 若 是 开发 模式 ， 则 
对 话 框 展示 完整 的 异常 信息 ， 包 括 输入 参数 、 异 常 代码 、 异 常 描 述 等 ， 若 是 上 线 模式 ， 则 对 话 
框 展示 相对 友好 的 提示 文字 ， 如 “当前 网 络 连接 失败 ， 请 检查 网 络 设置 是 否 开启 ”等 。 
下 面 是 对 话 框 工 具 类 的 代码 : 
public class DialogTool í 
public static boolean isShow = false; // false 表示 上 线 模式 ，true 表示 开发 模式 
public static int SYSTEM = 0; 
public static int IO = 1; 
public static int NETWORK - 2; 
private static String[] mError = ( "系统 异常 ， 请 稍 候 再 试 ", " 读 写 失 败 ， 请 清理 内 存 空间 后 再 试 "， 
"网 络 连 接 失 败 ， 请 检查 网 络 设置 是 否 开启 " }; 
public static void showError(Context ctx, int type, String title, Exception e) { 
AlertDialog.Builder builder = new AlertDialog.Builder(ctx); 
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builder.setTitle(title); 

if (isShow — true) í 
String desc = String.format("%sm 异常 描述 : 96s", mError[type], e.getMessage()); 
builder.setMessage(desc); 

} else í 
builder.setMessage(mError[type]); 

; 

builder.setPositiveButton(" 447E", null); 

builder.create().show(); 

1 


public static void showError(Context ctx, int type, String title, int code, String msg) { 
AlertDialog.Builder builder — new AlertDialog.Builder(ctx); 
builder.setTitle(title); 
if (isShow = true) { 
String desc = String. format("%s\n 异常 代码 : %d\n 异常 描述 : %s", mError[type], code, msg); 
builder.setMessage(desc); 
) else { 
builder.setMessage(mError[type]); 
J 
builder.setPositiveButton(" 确 定 ", null); 
builder.create().show(); 


} 
除了 代码 外 ，AndroidManifest.xml 还 要 区 分 开发 模式 与 上 线 模式 ， 有 以 下 3 点 修改 说 明 。 


CD) application 标签 中 加 上 属性 android:debuggable="true" 表 示 调 试 模式 ， 默认 false 表示 
上 线 模式 。 若 在 模拟 器 上 调试 或 通过 Android Studio 直接 把 App 安装 到 手机 上 ， 则 无 论 
debuggable 的 值 是 多 少 都 直接 切换 到 调试 模式 。 在 上 线 发 布 时 要 把 该 属性 设置 为 false。 

(2) App 发 布 后 ， 没 有 特殊 情况 ， 开 发 者 都 不 希望 activity 和 service 对 外 开放 。 但 其 默 
认 是 对 外 部 开放 的 , 所 以 要 在 activity 和 service 标签 下 分 别 添加 属性 android:exported= "false", 
表示 该 组 件 不 对 外 开放 。 

G) App 默认 安装 到 内 部 存储 ， 因 为 手机 与 平板 的 存储 空间 有 限 ， 所 以 应 该 尽量 让 App 
选择 安装 到 SD 卡 ， 避 免 占 用 宝贵 的 内 部 存储 空间 。 这 时 要 在 manifest 标签 下 加 上 属性 
android:installLocation， 该 属性 的 取 值 说 明 见 表 8-1。 





表 8-1 安装 位 置 的 取 值 说 明 


安装 位 置 的 类 型 ”| 说 明 








intemalOnly | 默认 值 ， 只 能 安装 在 内 部 存储 。 无 法 通过 安全 软件 的 应 用 搬家 功能 将 其 挪 到 SD 卡 
auto 优先 装 在 内 部 存储 ,但 若 内 部 存储 空间 不 足 ， 则 会 安装 在 SD 卡 。 安 装 之 后 ， 用 户 可 通过 


安全 软件 选择 是 否 将 其 挪 到 SD 卡 。 推 荐 设 为 该 值 


preferExtemal 安装 在 SD + E. 但 车 SD 卡 不 存在 或 SD 卡 空间 不 足 ， 则 安装 在 内 部 存储 
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8.2.3 ”数据 加 密 


大 家 都 知道 ， 数 据 安全 很 重要 ， 现 在 无 论 干什么 都 要 密码 ， 各 种 账号 和 密码 一 旦 泄露 必 
将 造成 财产 损失 。 但 是 Android 对 数据 安全 的 支持 很 弱 ， 并 没有 很 好 的 数据 保密 措施 。 

例如 ， 共 享 参数 SharedPreferences 本 质 上 是 操作 一 个 XML 配置 文件 ， 文 件 具体 路 径 为 
/data/data/ 应 用 包 名 /shared_prefs/***.xml; 打开 shared.xml 共享 参数 文件 后 里 面 全 部 都 是 明文 : 


<?xml version='1.0' encoding='utf-8' standalone='yes' ?> 
<map> 

<string name="name">Mr Lee</string> 

<int name="age" value="30" /> 

<boolean name="married" value="true" /> 

«float name="weight" value=" 100.0" /> 
</map> 


如 果 里 面 存放 用 户 的 银行 账号 与 密码 ， 不 要 说 是 黑客 ， 就 是 一 个 App 初学 者 拿 到 别人 手 
机 后 也 一 样 容易 获得 其 中 的 用 户 账号 信息 。 

SQLite 数据 库 也 不 安全 ， 数 据 库 文 件 具 体 路 径 为 /data/data/ 应 用 包 名 /databases/***.db。 这 
个 db 文件 未 经 加 密 处 理 , 只 要 弄 来 sqlitemanager 等 SQLite 的 管理 工具 , 就 能 轻松 查看 数据 库 
中 存储 的 各 种 信息 。 图 8-24 所 示 为 使 用 sqlitemanager AFH App 数据 库 的 表 记 录 。 
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图 8-24 SQLite 保存 的 数据 记录 信息 


用 户 数据 无 论 保存 在 SharedPreferences， 还 是 保存 在 SQLite 数据 库 ， 都 有 必要 对 关键 数 
据 进行 加 密 。 加 密 算法 多 种 多 样 ， 常 见 的 有 MD5. RSA, AES. 3DES 四 种 。 


1. MD5 加 密 


MD5 是 不 可 逆 的 加 密 算法 ， 也 就 是 无 法 解密 ， 主 要 用 于 客户 端的 用 户 密码 加 密 。MD5 算 
法 的 加 密 代码 如 下 : 
public class MDSUtil í 
public static String encryp(String raw) { 
String md5Str = raw; 
try { 
MessageDigest md = MessageDigest.getInstance("MD5"); 
md.update(raw.getBytes()); 





Android Studio 开交 实战 : 从 零 基 础 到 App 上 线 





byte[] encryContext = md.digest(); 
inti; 
StringBuffer buf = new StringBuffer(""); 
for (int offset = 0; offset < encryContext.length; offset) í 
i = encryContext[offset]; 
if (i <0) { 
i+=256; 
; 
if (i «16)1 
buf.append("0"); 
; 
buf.append(Integer.toHexString(i)); 
H 
md5Str = buf.toString(); 
} catch (NoSuchAlgorithmException e) { 
e.printStackTrace(); 
j 
return md5Str; 


j 


MDS 算法 的 加 密 效 果 如 图 8-25 所 示 , 无 论 原始 字符 串 
是 什么 ，MDS5 加 密 串 都 是 32 位 的 十 六 进 制 字符 串 。 


EMENFER : 123456 


2. RSA 加 密 MD5 加 刻 RSA — AES 加 密 。 3DES 加 刻 
MD5 的 加 密 结 里 


RSA 算法 在 客户 端 使 用 公 钥 加 密 ， 在 服务 端 使 用 私 钥 是 :e10adc3949ba59abbe56e057f20f883e 
解密 。 这 样 一 来 ， 即 使 加 密 的 公 钥 被 泄露 ， 没 有 私 钥 仍然 图 8-25 MDS 算法 的 加 密 结果 
无 法 解密 。 
下 面 是 RSA 加 密 的 3 个 注意 事项 。 
(1) 需要 导入 加 密 算法 的 依赖 包 bcprov-jdk16-1.46jar， 该 jar 包 要 放 在 当前 模块 的 libs 
目录 下 。 
(2) RSA 加 密 的 结果 是 字 节 数组 ， 经 过 BASE64 编码 才能 形成 最 终 的 加 密 字符 串 。 
(3) 依据 需求 要 对 加 密 前 的 字符 串 做 reverse 倒序 处 理 。 


RSA 算法 的 加 密 代码 如 下 : 


public class RSAUtil í 
private static final String Algorithm = "RSA"; 












private static byte[] encrypt(PublicKey pk, byte[] data) throws Exception í /加 密 
try{ 
Cipher cipher = Cipher.getInstance(Algorithm, 
new org.bouncycastle.jce.provider. BouncyCastleProvider()); 
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cipher.init(Cipher.ENCRYPT MODE, pk); 
int blockSize = cipher.getBlockSize(); 
int outputSize = cipher.getOutputSize(data.length); 
int leavedSize = data.length % blockSize; 
int blocksSize = leavedSize != 0 ? data.length / blockSize + 1 : data.length / blockSize; 
byte[] raw = new byte[outputSize * blocksSize]; 
inti = 0; 
while (data.length - í * blockSize > 0) í 
if (data.length - i * blockSize > blockSize) í 
cipher.doFinal(data, i * blockSize, blockSize, raw, i * outputSize); 
} else { 
cipher.doFinal(data, i * blockSize, data.length - i * blockSize, raw, i * outputSize); 


j 
ies 
l 
return raw; 


} catch (Exception e) í 
throw new Exception(e.getMessage()); 


private static byte[] decrypt(PrivateKey pk, byte[] raw) throws Exception { /解密 
try ( 
Cipher cipher = Cipher.getInstance(Algorithm, 
new org.bouncycastle.jce.provider.BouncyCastleProvider()); 
cipher.init(cipher DECRYPT MODE, pk); 
int blockSize — cipher.getBlockSize(); 
ByteArrayOutputStream bout = new ByteArrayOutputStream(64); 
int j = 0; 
while (raw.length - j * blockSize > 0) í 
bout.write(cipher.doFinal(raw, j * blockSize, blockSize)); 
j}; 


j 
return bout.toByteArray(); 
} catch (Exception e) í 
throw new Exception(e.getMessage()); 


// 使 用 N. e 值 还 原 公 钥 
private static PublicKey getPublicKey(String modulus, String publicExponent, int radix) 
throws NoSuchAlgorithmException, InvalidKeySpecException { 
BigInteger bigIntModulus = new BigInteger(modulus, radix); 
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BigInteger bigIntPrivateExponent = new BigInteger(publicExponent radix); 

RSAPublicKeySpec keySpec = new RSAPublicKeySpec(biglIntModulus, bigIntPrivateExponent); 
KeyFactory keyFactory = KeyFactory.getInstance(" RSA"); 

PublicKey publicKey — keyFactory.generatePublic(keySpec); 

return publicKey; 


/ 使 用 N、d 值 还 原 私 钥 
private static PrivateKey getPrivateKey(String modulus, String privateExponent, int radix) 
throws NoSuchAlgorithmException, InvalidKeySpecException { 
Biglnteger bigIntModulus = new BigInteger(modulus, radix); 
BigInteger bigIntPrivateExponent = new Biglnteger(privateExponent, radix); 
RSAPrivateKeySpec keySpec = new RSAPrivateKeySpec(bigIntModulus, bigIntPrivateExponent); 
KeyFactory keyFactory = KeyFactory.getInstance(" RSA"); 
PrivateKey privateKey = keyFactory.generatePrivate(keySpec); 
return privateKey; 


public static String encodeRSA(RSAKeyData key. data, String src) { /加 密 函 数 
if(key data —— null) { // 以 下 为 测试 用 的 密 钥 对 
key data = new RSAKeyData(); 
key data.public key — "10001"; 
key data.private key = "": 
key data.modulus = "c7f668eccc579bb75527424c2 1be31c104bb44c92 1b4788ebc82cddab 
5042909e2ea2dd7064315313924d7989019091e1371428527e79e9d1836397f847046ef25 19c9b65022b48bf157fe409 
18242155734e65467d04ac844dfa0c2ae512517102986ba9b624d67d4c920eae40b2f11c363b218a703467d342faa8171 
9f57e2c3"; 
key data.radix — 16; 
j 
try { 
PublicKey key = getPublicKey(key_data.modulus, key_data.public_key, key_data.radix); 
String rev = encodeURL(new StringBuilder(src).reverse().toString()); 
byte[] en_byte = encrypt(key, rev.getBytes()); 
String base64 = encodeURL(ConvertBytes ToBase64.BytesToBase64String(en_byte)); 
return base64; 
} catch (Exception e) { 
e.printStackTrace(); 
return "RSA 加 密 失败 "; 


private static String encodeURL(String str) { //URL 编码 
String encode str = str; 
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try { 

encode str = URLEncoder.encode(str, "utf-8"); 
} catch (Exception e) { 

e.printStackTrace(); 
; 


return encode str; 


private static String decodeURL(String str) { //URL 解码 
String decode str — str; 
try ( 
decode str = URLDecoder.decode(str, "utf-8"); 
} catch (Exception e) í 
e.printStackTrace(); 
J 


return decode str; 


public static class RSAKeyData í 
public String modulus; 
public String public key; 
public String private key; 
public int radix; 


public RSAKeyData() í 
modulus = ""; 
public key = ""; 
private key = ""; 
radix = 0; 


j; 
RSA 算法 的 加 密 效果 如 图 8-26 所 示 ， 加 密 结果 是 经 过 URL 编码 的 字符 串 。 


要 加 密 的 字符 串 : 123456 


MD5 加 密 。 RSA 加密。 AES 加 密 3DES 加 密 


是 :aLZOoc%2F%2BFL3fbHQFiYgCGdhRcY20z0bb%2F 
L3tYufeRmnFJ1ahn9ANwc4GMBsqpfyYWJ1W9y0nbd 
XMwwGltoFjuavwOD7QndP%2BbdwRqhJ526stQc35a 
2BwoyZJhENjWHwSdtETdfab8oYX7YLTaeljCQX9eX2e 
TERmzdkOnXwtVJM%3D 





图 8-26 RSA 算法 的 加 密 结果 
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3. AES WE 
AES 是 设计 用 来 替换 DES 的 高 级 加 密 算法 。 下 面 是 该 算法 加 密 和 解密 的 代码 : 


public class AesUtil { 
private static final String Algorithm = "AES"; 
private final static String HEX ="0123456789ABCDEF"; 


/加 密 函 数 。key 为 密 钥 

public static String encrypt(String key, String src) throws Exception í 
byte[] rawKey = getRawKey(key.getBytes()); 
byte[] result = encrypt(rawKey, src.getBytes()); 
return toHex(result); 


1 


/解密 函数 。key 值 必须 和 加 密 时 的 key 一 臻 
public static String decrypt(String key, String encrypted) throws Exception { 
byte[] rawKey = getRawKey(key.getBytes()); 
byte[] enc = toByte(encrypted); 
byte[] result = decrypt(rawKey, enc); 
return new String(result); 


} 


private static void appendHex(StringBuffer sb, byte b) í 
sb.append(HEX.charAt((b >> 4) & 0x0f)).append(HEX.charAt(b & 0x0f)); 


j 


private static byte[] getRawKey(byte[] seed) throws Exception í 
KeyGenerator kgen = KeyGenerator.getInstance( Algorithm); 
/| SHAIPRNG 强 随机 种 子 算法 , 要 区 别 Android 4.2.2 以 上 版 本 的 调用 方法 
SecureRandom sr = null; 
if (android.os.Build. VERSION.SDK INT >= 17) í 
sr = SecureRandom.getInstance("SHA I PRNG", "Crypto"); 
} else í 
sr = SecureRandom.getInstance("SHA IPRNG"); 
h 
Sr.setSeed(seed); 
kgen.init(256, sr); / 256 位 /128 位 /192 位 
SecretKey skey = kgen.generateKey(); 
byte[] raw = skey.getEncoded(); 
Teturn raw; 


j 


private static byte[] encrypt(byte[] key, byte[] src) throws Exception í 
SecretKeySpec skeySpec = new SecretKeySpec(key, Algorithm); 
Cipher cipher = Cipher.getInstance(Algorithm); 
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cipherinit(CipherENCRYPT MODE, skeySpec); 
byte[] encrypted — cipher.doFinal(src); 
return encrypted; 

5 


private static byte[] decrypt(byte[] key, byte[] encrypted) throws Exception í 
SecretKeySpec skeySpec = new SecretKeySpec(key, Algorithm); 
Cipher cipher — Cipher.getInstance(Algorithm); 
cipherinit(Cipher DECRYPT MODE, skeySpec); 
byte[] decrypted — cipher.doFinal(encrypted); 
return decrypted; 

} 


private static byte[] toByte(String hexString) { 
int len = hexString.length() / 2; 
byte[] result = new byte[len]; 
for (int i = 0; i < len; i^) í 
result[i] = Integer.valueOf(hexString.substring(2 * i, 2 * i + 2), 16).byteValue(); 
j 


return result; 


private static String toHex(byte[] buf) í 
if (buf == null) í 
return ""; 


] 
StringBuffer result = new StringBuffer(2 * buf.length); 
for (int i = 0; i < buf.length; i++) { 
appendHex(result, buffi]); 
J 


return result.toString(); 


; 
AES 算法 的 加 密 效 果 如 图 8-27 所 示 。 该 算法 是 可 逆 算 法 ， 支 持 对 加 密 字 符 串 进行 解密 ， 
前 提 是 解密 时 密 钥 必须 与 加 密 时 一 致 。 


要 加 密 的 字符 串 : 123456 


MD5 加 密 ”RSA 加 密 。 ” AES 加 密 3DES 加 密 


加 密 结果 是 :C120EF2142131FDC8B31D96316518464 
解密 结果 是 :123456 





图 8-27 AES 算法 的 加 密 结果 








Android Studio FERR: 从 零 基 础 到 App 上 线 





4. 3DES 加 密 





3DES (Triple DES) 是 三 重 数据 加 密 算法 ， 相 当 于 对 每 个 数据 块 应 用 3 次 DES 加 密 算法 。 
因为 原先 DES 算法 的 密 钥 长 度 过 短 ， 容 易 遭 到 暴力 破解 ， 所 以 3DES 算法 通过 增加 密 钥 的 1 
度 防范 加 密 数 据 被 破解 。 在 实际 开发 中 ，3DES 的 密 钥 必须 是 24 位 的 字 节 数组 ， 过 短 或 过 1 
在 运行 时 都 会 报错 java.security.InvalidKeyException。 另 外 ，3DES 加 密生 成 的 是 字 节 数组 ， 
得 通过 BASE64 编码 为 文本 形式 的 加 密 字 符 串 。 

该 算法 的 加 密 和 解密 代码 如 下 : 

public class Des3Util { 

private static final String Algorithm = "DESede"; // 定义 加 密 算法 DESede， 即 3DES 











匠 森森 


public static String encrypt(String key, String raw) { /加 密 函 数 。key 为 密 钥 
byte[] enBytes = encryptMode(key, raw.getBytes()); 
BASE64Encoder encoder = new BASEG4Encoder(); 
return encoder.encode(enBytes); 


} 


public static String decrypt(String key, String enc) { // 解 密 函 数 。key 值 必须 和 加 密 时 的 key 一 致 
try { 
BASE64Decoder decoder = new BASE64Decoder(); 
byte[] enBytes = decoder.decodeBuffer(enc); 
byte[] deBytes = decryptMode(key, enBytes); 
return new String(deBytes); 
) catch (IOException e) í 
e.printStackTrace(); 
return enc; 
] 
; 


private static byte[] encryptMode(String key, byte[] src) í 

try ( 
SecretKey deskey = new SecretKeySpec(build3DesK ey(key), Algorithm); 
Cipher cipher = Cipher.getInstance(Algorithm); 
cipher.init(Cipher.ENCRYPT MODE, deskey); 
return cipher.doFinal(src); 

jcatch (Exception e) í 
e.printStackTrace(); 
return null; 


j 


private static byte[] decryptMode(String key, byte[] src) í 
try{ 
SecretKey deskey = new SecretKeySpec(build3DesKey(key), Algorithm); 
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Cipher cipher = Cipher.getInstance(Algorithm); 
cipherinit(CipherDECRYPT MODE, deskey); 


return cipher.doFinal(src); 
jcatch (Exception e) í 
e.printStackTrace(); 
return null; 
; 
b 
/根据 字符 串 生成 密 钥 24 位 的 字 节 数组 


private static byte[] build3DesKey(String keyStr) throws UnsupportedEncodingException í 
byte[] key = new byte[24]; 
byte[] temp = keyStr.getBytes("UTF-8"); 
if (key.length > temp.length) { 
System.arraycopy(temp, 0, key, 0, temp.length); 
yelse í 
System.arraycopy(temp, 0, key, 0, key.length); 
b 


return key; 


j 


3DES 算法 的 加 密 效果 如 图 8-28 所 示 。 该 算法 与 AES 一 样 是 可 逆 算 法 ， 支 持 对 加 密 字符 
串 进 行 解密 ， 前 提 是 解密 时 密 钥 必 须 与 加 密 时 一 致 。 


要 加 密 的 字符 串 : 123456 


MD5 加 密 RSA 加 密 — AES 加密。 ”3DES 加 密 


加 密 结果 是 :CUyOh1msurY= 
解密 结果 是 :123456 





828 3DES 算法 的 加 密 结果 


8.3 安全 加 固 





本 节 介绍 对 APK 安装 包 进 行 安全 加 固 的 过 程 。 首 先 通 过 反 编 译 工 具 成 功 破解 App 源码 ， 
从 而 表明 对 APK 实施 安全 防护 的 必要 性 和 紧迫 性 ; 接着 详细 说 明代 码 混淆 的 原理 与 规则 ， 演 
示 代 码 混淆 如 何 加 大 源码 破译 的 难度 ;然后 描述 怎样 利用 第 三 方 加 固 网 站 对 APK 做 加 固 处 理 ; 
最 后 演示 对 加 固 包 进 行 重 签名 的 方法 。 

834 反 编 译 


编译 是 把 代码 编译 为 程序 ， 反 编译 是 把 程序 破解 为 代码 。 
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谁 都 不 想 自 己 的 劳动 成 果 被 别人 窃取 , 何况 是 辛 辛 苦 苦 敲 出 来 的 App 代码 , 然而 由 于 Java 
语言 的 特性 ，Java 写 的 程序 往往 容易 被 反 编 译 破解 ， 只 要 获得 App 的 安装 包 ， 就 能 通过 反 编 
译 工具 破解 出 该 App 的 完整 源码 。 开 发 者 绞 尽 脑汁 上 架 一 个 App， 结 果 这 个 App 却 被 他 人 从 
界面 到 代码 都 “山寨 ”了 ， 那 可 真是 欲 活 无 泪 了 。 为 了 说 明代 码 安 全 的 重要 性 ， 下 面 对 反 编译 
的 完整 过 程 进行 介绍 ， 警 醒 开 发 者 防火 、 防 盗 、 防 破解 。 

首先 准备 反 编 译 的 3 个 工具 ， 分 别 是 apktool、dex2jar、jd-gui， 注 意 下 载 最 新 版 本 。 

e apktool: 对 APK 文件 进行 解 包 ， 主 要 用 来 解析 res 资源 和 AndroidManifest.xml。 

e dex2jar: 将 APK 包 中 的 classes.dex 转 为 JAR 包 ， 该 JAR 包 就 是 App 代码 的 编译 文件 。 

e jd-gui: 将 dex2jar 解析 出 来 的 jar 包 反 编译 为 Java 源码 。 

下 面 是 反 编 译 APK 的 具体 步骤 (以 Window 环境 举例 说 明 ) o 

€D 打开 DOS 命令 窗口 ， 进 入 apktool 所 在 的 目录 ， 运 行 “apktool.bat d -f 解 包 后 的 保存 目 

录 名 待 处 理 的 APK 文件 名 ”， 等 待 反 编译 过 程 ， 如 图 8-29 所 示 。 



































图 8-29 反 编 译 工 具 apktool 的 运行 截图 


反 编 译 通 过 ， 即 可 在 当前 目录 下 看 到 破解 目录 。apktool 的 主要 目的 是 解析 出 res 资源 ， 包 括 
AndroidManifest.xml 和 res/layout、res/values、res/drawable 等 目录 下 的 资源 文件 。 





CXX02 用 压缩 软件 (如 Winrar) 打开 APK &, APK 安装 包 其 实 是 一 个 压缩 文件 ， 使 用 Winrar 
F APK 文件 的 目录 结构 如 图 8-30 所 示 。 


SB test-debug. apk - WinRAR . leai 
文件 (E) 命令 (C) g 收藏 天 (0) 选项 (GD DM 
JM be Q ` 

添加 解压 到 pe 查看 Hs ”查找 信息 Ë, £ 
Œ s test-debug. apk - ZIP 压缩 文件 ， 解 包 大 小 为 5,172,179 字 节 — ~ 


























a+ 
3H 




















| 名 称 大 小 ”压缩 后 大 小 类 型 
E xt 
res 文件 来 
org 文件 夹 
NETA-INF 文件 夹 
Lresources. arsc 206, 596 206, 596 ARSC 文件 
classes. dex 4,501,672 — 1,382,504 DEX 文件 
Androidllanifest. xal 2,184 767 XNL 文件 
SS" 总 计 3 文件 夹 和 由 710, 452 字 节 


图 8-30 Apk 解压 后 的 内 部 目录 结构 
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先 从 APK 包 中 解压 出 classes.dex 文件 ， 再 进入 dex2jar 所 在 的 目录 ， 运 行 命令 d2j-dex2jar.bat 
classes.dex， 等 到 破解 完成 ， 即 可 在 当前 目录 下 看 到 新 文件 classes_dex2jarjar， 该 JAR 包 即 为 App 源 
码 的 编译 文件 。 

CX303 双击 打开 jd-gui.exe， 用 鼠标 把 classes_dex2jarjar 拖 到 jd-gui 界面 中 ， 程 序 就 会 自动 把 
JAR 包 反 编译 为 Java 源码 ， 反 编译 后 的 Java 源码 目录 结构 如 图 8-31 所 示 。 


|Š Java Decompiler - LogTeol. class 






































m. Ü) AesUtil 
时 国 Des3Ut11 
= B WDSUtil 
回 - 国 RSAUtil 


& util 

aD Masa dines bird 

n Lcg.d(parazStringl, paramString2); 
1 

1 


obli static void e(String paremStrirgl, String paranstring?) 
e 1 (String, String) : voic 
vw v(String, String) : 
e v(String, String) : void | 
sivtf(String, String) : void 1 
BD TosstTool 
t D Eutldconfig public static void :String parenstrirgl, String paramStringi) 
b 国 Enezypt&ctivity 
+ My MainActivity it (asshoy == true) 
HAR , Pa tpasasoetsq1, peranseziag2) 7 


ar (isshov 一 true) 
Log.e(paranStringl, paranStrinç2); 
) 





5B] Versionkctivity 


c 8B erg. bouncycactle. u 


图 8-31 反 编 译 后 的 java 源码 目录 结构 


在 jd-gui 界面 依次 选择 菜单 File 一 Save All Sources， 输 入 保存 路 径 ， 在 指定 目录 生成 zip 文件 ， 
解压 zip 文件 就 能 看 到 反 编 译 后 的 全 部 Java 代码 了 。 


上 面 的 反 编译 过 程 不 但 破解 了 Java 代码 ， 而 且 res 资源 文件 也 被 一 起 破解 了 ， 如 果 你 的 
App 不 采取 一 些 保护 措施 , 整个 工程 源码 就 会 暴露 在 大 庭 广 众 之 下 。 所 以 要 赶紧 扯 些 遮羞 布 盖 
上 ， 穿 好 衣服 裤子 ， 告 别 原始 社会 ， 走 进 文明 社会 。 

832 ”代码 混淆 


前 面 说 到 反 编译 能 够 破解 App 的 整个 工程 源码 ， 因 此 有 必要 对 App 源码 采取 防护 措施 ， 
代码 混淆 就 是 保护 代码 安全 的 措施 之 一 。Android Studio 已 经 自 带 了 代码 混淆 器 ProGuard， 用 
途 包括 以 下 两 点 : 


(1) 压缩 APK 包 的 大 小 ， 删 除 无 用 代码 ， 并 简化 部 分 类 名 和 方法 名 。 
(2) 加 大 破解 源码 的 难度 ， 部 分 类 名 和 方法 名 被 重 命 名 使 得 程序 逻辑 变 得 难以 理解 。 
代码 混淆 的 配置 文件 其 实 一 直 都 存在 ,只 是 我 们 之 前 都 将 其 忽略 了 。 每 次 在 Android Studio 
新 建 一 个 模块 ,该 模块 的 根 目录 下 都 会 自动 生成 proguard-rules.pro。 打 开 build.gradle, 在 android 
一 buildTypes 一 release 节点 下 可 以 看 到 两 行 编译 配置 : 
minifyEnabled false 
proguardFiles getDefaultProguardFile('proguard-android.txt'). 'proguard-rules.pro' 





Android Studio 开交 实战 : 从 零 基础 到 App 上线 





Android Studio 默认 不 做 代码 混淆 ， 上 面 第 一 行 的 minifyEnabled 为 false 表示 关闭 混 清 功 
能 ， 要 把 该 参数 改 为 true 才能 开启 混 清 功 能 。 第 二 行 配 置 指定 proguard-rules.pro 作为 本 模块 
的 代码 混淆 文件 ， 该 文件 保存 的 是 各 种 详细 的 代码 混淆 规则 。 

下 面 是 proguard-rules.pro 的 一 个 模板 : 

# 指 定 代 码 的 压缩 级 别 


-optimizationpasses 5 
# 是 否 使 用 大 小 写 混合 
-dontusemixedcaseclassnames 
# 优 化 /不 优化 输入 的 类 文件 
-dontoptimize 
# 是 否 混淆 第 三 方 JAR 包 
-dontskipnonpubliclibraryclasses 
TRE ISE S CURES. 
-dontpreverify 
TRE ISI RE io H 25 
-verbose 
TRECE IRSE PEACUH RU SETA 
-optimizations !code/simplification/arithmetic,!field/*,!class/merging/* 
# 保 护 注解 
-keepattributes *Annotation* 
# 保 持 JNI 用 到 的 native 方法 不 被 混淆 
-keepclasseswithmembers class * í 

native <methods>; 
j 
# 保 持 自 定义 控件 的 构造 函数 不 被 混淆 ， 因 为 自 定义 控件 很 可 能 直接 写 在 布局 文件 中 
-keepclasseswithmembers class * í 

public «init» (android.content.Context, android.util.AttributeSet); 
] 
# 保 持 自 定义 控件 的 构造 函数 不 被 混淆 
-keepclasseswithmembers class * { 

public «init» (android.content.Context, android.util.AttributeSet, int); 
J 
# 保 持 布局 中 onClick 属性 指定 的 方法 不 被 混淆 
-keepclassmembers class * extends android.app.Activity í 

public void *(android.view.View); 

; 
# 保 持 枚 举 enum 类 不 被 混淆 
-keepclassmembers enum * í 

public static **[] values(); 

public static ** valueOf(java.lang.String); 
; 
# 保 持 序列 化 的 Parcelable 不 被 混淆 
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-keep class * implements android.os.Parcelable í 
public static final android.os.ParcelableSCreator *; 


} 

# 指 定 哪些 第 三 方 JAR 包 需 要 混淆 

#-libraryjars libs/bcprov-jdk16-1.46.jar 

# 保 持 哪些 系统 组 件 类 不 被 混淆 

-keep public class * extends android.app.Fragment 

-keep public class * extends android.app.Activity 

-keep public class * extends android.app.Application 

-keep public class * extends android.app.Service 

-keep public class * extends android.content.BroadcastReceiver 

-keep public class * extends android.content.ContentProvider 

-keep public class * extends android.app.backup.BackupA gentHelper 

-keep public class * extends android.preference.Preference 

-keep public class * extends android.support.v4.** 

-keep public class com.android.vending.licensing.ILicensingService 

# 保 持 哪 些 第 三 方 JAR 包 不 被 混淆 。 比 如 上 一 节 RSA 算法 用 到 了 beprov-jdk16-1.46.jar, iX JAR 包 里 的 
工具 类 就 不 可 混淆 

-keep class org.bouncycastle.** 

-dontwarn org.bouncycastle.** 


进行 代码 混淆 时 有 以 下 5 点 注意 事项 : 

CD 对 某 些 特殊 的 类 或 方法 屏蔽 混淆 ， 可 能 会 在 布局 文件 中 直接 引用 类 名 或 方法 名 ， 包 
括 自 定义 控件 、 布 局 中 onClick 属性 指定 的 方法 等 。 

(2) 保持 第 三 方 JAR 包 不 被 混淆 ， 有 时 需要 把 keep class 提 到 dontwarn 前 面 。 

G) JAR 包 的 文件 名 中 不 要 有 特殊 字符 ， 比 如 “(”“)” 等 字符 在 混淆 时 会 报错 ， 文 件 
名 最 好 只 包含 字母 、 横 线 、 小 数 点 。 

(4) jni 的 方法 要 屏蔽 混淆 ， 因 为 so 库 要 求 包 名 、 类 名 、 函 数 名 完全 一 致 。 

(5) 使 用 WebView 时 会 被 js 调用 的 类 和 方法 也 要 屏蔽 混淆 。 具 体 做 法 除了 要 在 
proguard-rules.pro 加 上 说 明 外 ， 还 要 在 Java 代码 中 调用 js 使 用 的 方法 ， 才 能 保证 内 部 类 与 相 
关 方 法 都 没有 被 混淆 。 

-keep class com.example.mixture. WebActivity$MobileSignal{ 
public «fields»; 
public «methods; 

1 


经 过 代码 混淆 后 重新 生成 的 APK 文件 ， 再 用 反 编 译 工 具 进行 破解 ， 反 编译 后 的 Java 源码 
结构 如 图 8-32 所 示 。 

从 图 中 看 到 ， 混 淆 处 理 后 的 包 名 与 类 名 都 变 成 了 a. b. c. d 这 样 的 名 称 ， 无 疑 加 大 了 黑 
客 理解 源码 的 难度 。 试 想 当 黑 客 面 对 这 些 天 书 般 的 a、b、c、d， 还 会 想 要 绞 尽 脑汁 地 尝试 破 
译 吗 ? 








Android Studio 开发 实战 : 从 零 基础 到 App 上 线 








[5 mpiler 
File Edit Navigate Search Help 
wie yo 
T dasses-dex2jar jar > 

5-8 android. support 
Ü fB con. exanple. test 













package com.example.test.a; 





















* import android.os.Build.VERSION; 
public class a 

a t 
sê a(String) : byte[] public static String a(String paramStringl, String paramString2) 
ea(String String) : St] t 

w a(StringBuffer, byte) return b(a(a(paramStringl.getBytes()), paramString2.getBytes())); 
s a(byte[]) : bytel] ; 

s a(byte[], byte[]) : by private static void a(StringBuffer paramStringBuffer, byte paramByte) 
er b(String, String : St] | ( 

s b(byte[]) : String paranStringBuffer.append(*0123456789ABCDEF".charAt(0xF 5 paramByte J 
= b(byte[], byte[]) : by 1 


private static bjte[] a(String paramString) 
申 { 
? int 1 = parasString.length() / 2; 
byte[] arzayOfByte = new byte[1]; 
-D Eneryptáctivity for ps 3 ran, < rini ñ : 
S-P MainActivity arrayOfByte[j] = Integer.valueOf(paramString.substring(] * 2, 2 + 
a- VersionActivity } 
5-8 org. bouncycastle return arrayOfByte: 
1 









图 8-32 ”经 过 代码 混淆 再 破解 后 的 Java 源码 目录 结构 


833 ”第 三 方 加 固 及 重 签名 


App 经 过 代码 混淆 后 初步 结束 了 裸奔 的 状态 , 但 代码 混淆 只 能 加 大 源码 破译 的 难度 , 并 不 
能 完全 阻止 被 破解 。 除 了 代码 破解 外 ，App 还 存在 其 他 安全 风险 ， 比 如 二 次 打包 、 算 改 内 存 、 
漏洞 暴露 等 情况 。 对 于 这 些 安全 风险 ，Android Studio 基本 无 能 为 力 。 因 此 ， 鉴 于 术 业 有 专攻 ， 
我 们 不 如 把 APK 文件 交 给 专业 加 固 网 站 进行 加 固 处 理 。 举 个 做 得 比较 好 的 第 三 方 加 固 的 例子 ， 
360 加 固 保 的 网 址 是 http:Wiiagu.360.cn/。 开 发 者 要 先 在 该 网 站 注册 新 用 户 ， 然 后 打开 在 线 加 固 
页 面 ， 加 固 页 面 如 图 8-33 所 示 。 





Fg 8-33 360 加 固 保 的 在 线 加 固 页 面 


单 击 该 页 面 的 “上 传 应 用 ”按钮 ， 上 传 成 功 后 跳 到 下 一 页 ， 向 下 拉 到 页 面 底部 ， 选 中 “ 正 
版 签名 ”开启 加 固 按 钮 ， 如 图 8-34 所 示 。 





为 确保 “ 防 二 次 亲 包 ” 功 能 正常 使 用 ， 清 确认 上 传 应 用 的 怎 名 为 
GBS o MEE 








834 ”确认 加 固 页 面 
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单 击 “开始 加 固 ”按钮 ， 跳 到 应 用 信息 页 面 ， 如 图 8-35 所 示 。 





8-35 加 固 后 的 应 用 信息 页 面 


应 用 信息 中 部 的 当前 状态 为 “加 固 成 功 ”， 单 击 右边 的 “下 载 应 用 ”按钮 ， 把 加 固 好 的 
安装 包 下 载 到 本 地 ， 下 载 后 的 文件 名 如 test-release.encrypted.apk。 此 时 用 反 编译 工具 尝试 破解 
这 个 加 固 包 ， 会 发 现 该 安装 包 变 得 无 法 破译 。 

加 固 后 的 APK 破坏 了 原来 的 签名 ， 无 法 直接 安装 到 手机 上 ， 所 以 要 对 该 文件 进行 重 签名 ， 
才能 成 为 合法 的 APK 安装 包 。 重 签名 用 到 两 个 工具 ， 分 别 是 jarsigner 和 zipalign， 有 具体 说 明 如 下 : 





1.jarsigner 


jarsigner 是 Java 自 带 的 JAR 包 签 名 工具 ， 路 径 为 Java 安装 目录 下 的 jdk/bin/jarsigner.exe, 
使 用 命令 的 格式 为 “jarsigner -verbose -keystore 密 钥 文件 全 路 径 -storepass 密 钥 文件 的 密码 
-keypass 别名 的 密码 -digestalg SHA1 -sigalg MDSwithRSA -signedjar 签名 后 的 文件 名 待 签名 
的 文件 名 别名 ”。 


2.zipalign 


zipalign 是 Android 开发 工具 包 SDK 自 带 的 APK 优化 工具 ， 相 当 于 内 存 对 齐 从 而 提高 读 
取 效 率 , 路 径 为 SDK 安装 目录 下 的 build-tools/ 版 本 号 /zipalign.exe, 使 用 命令 的 格式 为 “zipalign 
-V4 已 签名 的 文件 名 对 齐 后 的 文件 名 ”。 

下 面 对 加 固 好 的 APK 文件 进行 重 签 名 ， 完 整 的 命令 如 下 : 

jarsigner -verbose -keystore test.jks -storepass 111111 -keypass 111111 -digestalg SHA1 -sigalg 
MDSwithRSA -signedjar test-release-signed.apk test-release.encrypted.apk test 

zipalign -v 4 test-release-signed.apk test-release-signed-align.apk 

上 述 命令 里 的 test-release-signed.apk 表示 签名 后 的 文件 ，test-release-signed-align.apk 表示 
对 齐 后 的 最 终 安 装 包 。 

当然 , 命令 行 方式 不 够 友好 , 现在 有 专门 的 重 签名 软件 , 比如 爱 加 密 的 签名 软件 APKSign, 
下 载 该 软件 并 安装 ， 安 装 完毕 后 打开 APKSign， 该 软件 的 界面 如 图 8-36 所 示 。 

1E APKSign 界面 上 选择 待 签名 的 APK， 再 选择 签名 文件 的 路 径 ， 然 后 依次 输入 密码 、 别 
名 、 别 名 的 密码 、 签 名 后 的 存放 路 径 ， 输 入 效果 如 图 8-37 所 示 ， 最 后 单 击 “ 开 始 签名 ”按钮 
完成 签名 操作 。 





* 295 * 





Android Studio 开发 实战 :从 零 基础 到 App 上 线 





























(Orcus EO i sasa iiia 
e= ) Engish picni e ox T engish emeh 
选择 轨 签 各 AP WS3EEEESAPK: 
FS — | m FAStudoPijects Hol WortAcost test ielaso. encrypted apk | 
L. 3 I 选择 签名 立 件 : 
三 FiStdchijecs elo estes js (Em) m: FiSkudoPrjeclielourre ces tet ») | 
r^ wawa i = 
E tet l| s= k|—— S— | | 
! 
E: ge: m 
| 
EAP z: | | SREAP UR: ! 
和 名 后 位 十 : 366... [| septum:  FAStudoProjects Hellov/orcV-ast!test-release. encrypted, sgne [m 
PER [CB ] ! FER r= 
PPE 

















图 8-36 ” 爱 加 密 的 重 签名 工具 界面 图 8-37 信息 填写 好 的 重 签名 工具 界面 


84 ”发 布 到 应 用 商店 


本 节 介 绍 把 App 发 布 到 应 用 商店 的 过 程 。 首 先 要 在 应 用 商店 注册 开发 者 账号 ， 以 腾讯 开 
放 平台 为 例 说 明 开 发 者 注册 账号 的 步骤 ;然后 使 用 已 注册 的 开发 者 账号 在 开放 平台 上 创建 并 提 
交 应 用 ;最 后 描述 如 何 查看 应 用 上 线 的 审核 结果 ， 以 应 用 宝 App 为 例 说 明 搜索 并 安装 已 上 线 
App 的 方法 。 
8.4.1 注册 开发 者 账号 


APK 文件 完成 签名 后 ， 可 谓 是 万 事 俱 备 ， 只 从 东风 了 ， 接 下 来 把 App 发 布 到 各 大 应 用 市 
场 。 主 要 的 应 用 商店 有 应 用 宝 、 百 度 手机 助手 、360 手机 助手 、 小 米 应 用 商店 、 华 为 应 用 商店 、 
豌豆 莱 等 。 下 面 举例 说 明 如 何 将 你 的 App 发 布 到 应 用 宝 。 

应 用 宝 只 是 手机 上 的 应 用 商店 App 名 称 ， 
对 应 的 开发 者 后 台 是 腾讯 开放 平台 ， 网 址 是 
http://op.open.qq.com/。 读 者 应 该 都 有 QQ 账号 ， 
直接 用 QQ 号 码 登 录 腾 讯 开 放 平 台 , 跳 转 到 开发 
者 注册 页 面 ， 如 图 8-38 所 示 。 

如 果 是 个 人 开发 者 ， 就 单 击 左边 的 “个 人 ” 
类 型 ， 如 果 是 公司 开发 者 ， 就 单 击 右 边 的 “ 公 
司 ” 类 型 。 这 里 我 们 选择 “个 人 ”类 型 ， 跳 转 
到 下 一 页 的 个 人 资料 页 面 填写 个 人 信息 ， 如 图 
8-39 所 示 ; 填写 联系 方式 ， 如 图 8-40 所 示 。 

个 人 资料 填写 完成 后 ， 单 击 “ 下 一 步 ”按钮 ， 跳 转 到 验证 邮箱 页 面 。 打 开 你 的 注册 邮箱 ， 
找到 腾讯 开放 平台 的 开发 者 注册 认证 邮件 ， 点 击 邮件 中 的 确认 链接 ， 完 成 开发 者 的 注册 认证 。 





图 8-38 腾讯 开放 平台 的 开发 者 注册 页 面 
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图 8-39. 个 人 信息 的 填写 页 面 图 8-40 联系 方式 的 填写 页 面 
842 创建 并 提交 应 用 


开发 者 注册 完成 后 ， 回 到 腾讯 开放 平台 的 主页 ， 在 管理 中 心 页 面 上 单 击 “ 创 建 应 用 ” 按 
钮 ， 跳 转 到 应 用 创建 页 面 ， 如 图 8-41 所 示 。 
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图 841 腾讯 开放 平台 的 应 用 创建 页 面 


在 该 页 面 上 选择 最 左边 的 “移动 应 用 安 卓 ”， 然 后 单 击 下 方 的 “创建 应 用 ”按钮 ， 在 弹 
出 的 类 型 对 话 框 中 选择 “软件 ”， 如 图 8-42 所 示 。 








图 8-42 应 用 类 型 的 选择 对 话 框 
单 击 “ 确 定 ” 按 钮 ， 跳 转 到 应 用 信息 填写 页 面 ， 依 次 填写 应 用 的 各 项 基本 信息 ， 包 括 应 











有 名称、 应 用 类 型 、 应 用 标签 、 应 用 简介 等 ， 示 例 效果 如 图 8-43 所 示 。 
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图 8-43 ”应 用 信息 的 填写 页 面 
分 别 上 传 安装 包 、 应 用 图 标 ， 填 写 应 用 的 适 配 信 息 ， 如 图 8-44 所 示 。 
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图 标 素材 


适 配 信息 


版 权证 明 ( 可 选 
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图 8-44 上传 安装 包 、 应 用 图 标 等 信息 的 页 面 


最 后 单 击 页 面 右 下 方 的 “提交 审核 ”按钮 ， 等 待 开放 平台 的 人 工 审 核 。 审 核 一 般 需 要 1 一 
3 个 工作 日 ， 一 旦 通过 审核 ， 你 的 QQ 邮箱 会 收 到 一 封 审核 通知 邮件 。 此 时 重新 打开 腾讯 开放 
平台 ， 进 入 管理 中 心 ， 页 面 上 多 了 一 个 已 上 线 应 用 的 记录 ， 如 图 8-45 所 示 。 


已 上 线 (1) 未 上 绪 ( Q 创建 应 用 








应 用 名 称 状态 Hima 应 用 等 级 AFER 总 下 载 量 it 
e E Bre 
图 8-45 管理 中 心 的 已 上 线 应 用 记录 


若 想 验证 该 App 是 否 确 实 上 线 成 功 , 则 可 打开 手机 上 的 应 用 宝 App, 搜索 该 App 的 名 称 ， 
搜索 结果 会 出 现 该 App 的 应 用 信息 ， 如 图 8-46 所 示 。 
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846 ”应 用 宝 App 上 的 应 用 搜索 结果 


点 击 该 应 用 右边 的 “下 载 ” 按 钮 ， 即 可 开始 下 载 操 作 ， 下 载 完 毕 后 点 击 “ 安 装 ” 按 钮 ， 
App 就 可 以 成 功 安装 到 用 户 手机 上 。 


85 小 结 


本 章 主要 介绍 了 App 从 调试 到 发 布 的 详细 过 程 ， 包 括 调试 工作 (模拟 器 调试 、 真 机 调试 、 
导出 APK 安装 包 ) 、 准 备 上 线 〈 版 本 设置 、 上 线 模式 、 数 据 加 密 ) 、 安 全 加 固 〈 反 编译 、 代 
码 混淆 、 第 三 方 加 固 及 重 签名 ) 、 发 布 到 应 用 商店 〈 注 册 开 发 者 账号 、 创 建 并 提交 应 用 、 从 应 
用 商店 下 载 应 用 ) 。 经 过 这 一 系列 应 用 发 布 流程 ， 完 成 了 App 从 开发 阶段 的 代码 到 用 户 手机 
上 的 应 用 的 华丽 转变 ， 实 现 App“ 开 发 ”一 “测试 ”一 “加 固 ” 一 “上 线 ” 的 完整 过 程 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 5 种 开发 技能 : 

d) 学 会 通过 模拟 器 和 真 机 对 App 进行 调试 。 
(2) 学 会 把 App 工程 从 开发 模式 转 为 上 线 模式 。 
(3) 学 会 利用 签名 证 书 导 出 APK 安装 包 。 

(4) 学 会 对 APK 包 进行 安全 加 固 和 重 签名 。 
(5) 学 会 把 App 发 布 到 各 大 应 用 商店 。 








A zant 


本 章 介 绍 App 开发 常用 的 一 些 设备 操作 ， 主 要 包括 如 
何 使 用 摄像 头 进行 拍照 、 如何 使 用 麦克 风 进 行 录音 并 结合 摄 
像 头 进行 录像 、 如 何 播放 录制 好 的 音频 和 视频 、 如 何 使 用 党 
见 传感器 实现 业务 功能 、 如 何 使 用 定位 功能 获取 位 置信 息 
等 。 最 后 结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 仿 微 信 的 
发 现 功能 ”的 设计 与 实现 。 
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91 摄像 X 


本 节 介 绍 利用 摄像 头 实现 相机 功能 的 办 法 , 首先 对 表面 视图 SurfaceView 的 用 法 进行 说 明 ， 
演示 如 何 运用 相机 类 Camera 结合 表面 视图 完成 拍照 功能 〈 含 单 拍 和 连 拍 ) 。 然 后 对 表面 视图 
的 升级 版 一 一 纹理 视图 TextureView 的 用 法 进行 曾 述 , 并 演示 如 何在 新 版 Camera2 架构 中 结合 
纹理 视图 完成 拍照 功能 〈 含 单 拍 和 连 拍 ) 。 


9.1.1 表面 视图 SurfaceView 


Android 的 绘图 机 制 是 由 UI 线程 在 屏幕 上 绘图 ， 一 般 情 况 下 不 允许 其 他 线程 直接 做 绘图 
操作 。 这 个 机 制 在 处 理 简单 页 面 时 没什么 问题 ， 因 为 普通 页 面 不 会 频繁 且 大 面积 地 绘图 ， 但 是 
该 机 制 在 处 理 复杂 多 变 的 页 面 时 会 产生 问题 ,比如 时 刻 变 化 着 的 游戏 界面 、 拍 照 或 录像 时 不 断 
变换 着 的 预览 界面 就 会 导致 UI 线程 资源 堵塞 ， 即 界面 卡 死 的 状况 。 

表面 视图 SurfaceView 是 Android 用 来 解决 子 线程 绘图 的 特殊 视图 ,拥有 独立 的 绘图 表面 ， 
即 不 与 其 宿主 页 面 共享 同一 个 绘图 表面 。 由 于 拥有 独立 的 绘图 表面 , 因此 表面 视图 的 界面 能 够 
在 一 个 独立 线程 中 进行 绘制 ， 这 个 子 线程 为 泻 染 线程 。 因 为 泻 染 线程 不 占用 主线 程 资源 ， 所 以 

-方面 可 以 实现 复杂 而 高 效 的 UI 刷新 ， 另 一 方面 及 时 响应 用 户 的 输入 事件 。 由 于 表面 视图 具 
备 以 上 特性 ， 因 此 可 用 于 拍照 和 录像 的 预览 界面 ， 也 可 用 于 游戏 的 实时 界面 。 

因为 表面 视图 不 在 UI 主线 程 绘 图 ， 无 论 是 onDraw 方法 还 是 dispatchDraw 方法 都 没有 进 
行 绘图 操作 ， 所 以 表面 视图 必然 要 通过 其 他 途径 绘图 ， 这 个 途径 便 是 内 部 类 表面 持 有 者 
SurfaceHolder 外 部 调用 SurfaceView 对 象 的 getHolder 方法 获得 SurfaceHolder 对 象 ， 然 后 进行 
预览 界面 的 相关 绘图 操作 。 

下 面 是 SurfaceHolder 的 常用 方法 。 


e lockCanvas: 锁定 并 获取 绘图 表面 的 画布 。 

e unlockCanvasAndPost: 解锁 并 刷新 绘图 表面 的 画布 。 

e addCallback: 添加 绘图 表面 的 回调 接口 SurfaceHolder.Callback。 回 调 接口 有 以 下 3 个 方 
x. 
> surfaceCreated: 在 绘图 表面 创建 后 触发 ， 可 在 此 打开 相机 。 
> surfaceChanged: 在 绘图 表面 变更 后 触发 。 
> surfaceDestroyed: 在 绘图 表面 销毁 后 触发 。 

e removeCallback: 移 除 绘图 表面 的 回调 接口 。 

e isCreating: 判断 绘图 表面 是 否 有 效 。 如 果 在 别处 操作 SurfaceView， 就 要 判断 当前 绘图 表 
面 是 否 有 效 。 

e getSurface: 获取 绘图 表面 的 对 象 ， 即 预览 界面 。 

e setFixedSize: 设置 预览 界面 的 尺寸 。 

e setFormat: 设置 绘图 表面 的 格式 。 
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绘图 格式 的 取 值 说 明 见 表 9-1. 
表 9-1 绘图 格式 的 取 值 说 明 











PixelFormat 类 的 绘图 格式 类 型 说 明 
TRANSPAREN 透明 
TRANSLUCENT 半 透 明 
OPAQUE 不 透明 





下 面 用 一 个 具体 的 例子 说 明 普通 视图 与 表面 视图 的 区 别 。 图 9-1 和 图 9-2 所 示 为 普通 视图 
在 UI 线程 中 转动 扇形 区 域 的 效果 图 ， 前 后 两 个 界面 的 扇形 大 小 相同 ， 只 是 角度 不 同 。 


device 
停止 


9-1 普通 视图 的 转动 界面 1 图 9-2 普通 视图 转 的 动 界面 2 
再 来 看 表面 视图 转动 扇形 区 域 的 效果 图 ， 此 时 开启 了 两 个 线程 ， 一 个 线程 绘制 红色 扇形 ， 
另 一 个 线程 绘制 青色 扇形 ， 前 后 两 个 时 间 点 的 画面 如 图 9-3 和 图 9-4 所 示 。 


~N 














9-3 ”表面 视图 的 转动 界面 1 图 94 表面 视图 的 转动 界面 2 
从 表面 视图 的 转动 效果 可 以 看 到 ， 它 与 普通 视图 在 处 理 上 的 区 别 主要 有 以 下 两 点 : 


CD 表面 视图 允许 开启 多 个 线程 同时 进行 绘图 操作 ， 而 普通 视图 只 有 一 个 UI 线程 可 以 
绘图 。 

(2) 表面 视图 不 会 自动 清空 上 次 的 绘图 结果 ， 即 绘图 操作 是 增 量 进行 的 ， 而 普通 视图 在 
每 次 绘图 前 都 会 清空 上 次 的 绘图 结果 。 
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9.1.2 ”使 用 Camera 拍照 


相机 Camera 是 直接 操作 摄像 头 硬件 的 工具 类 ， 包 括 后 置 摄像 头 和 前 置 摄像 头 ， 有 以 下 常 
用 方法 。 


e getNumberOfCameras: 获取 本 设备 的 摄像 头 数 目 。 
e open: 打开 摄像 头 ， 默 认 打 开 后 置 摄像 头 。 如 果 有 多 个 摄像 头 ， 那 么 open(0) 表 示 打 开 后 
置 摄像 头 ，open(1) 表 示 打 开 前 置 摄像 头 。 
e getParameters: 获取 摄像 头 的 拍照 参数 ， 返 回 Camera.Parameters 对 象 。 
e setParameters: 设置 摄像 头 的 拍照 参数 。 具 体 的 拍照 参数 通过 调用 Camera.Parameters 的 
下 列 方法 进行 设置 。 
> setPreviewSize: 设置 预览 界面 的 尺寸 。 
> setPictureSize: 设置 保存 图 片 的 尺寸 。 
> setPictureFormat: 设置 图 片 格式 。 一般 使 用 ImageFormat.JPEG 表示 JPG 格式 。 
> setFocusMode: 设置 对 焦 模 式 。 一 般 使 用 Camera.Parameters.FOCUS_MODE_AUTO 表示 
e setPreviewDisplay: 设置 预览 界面 的 表面 持 有 者 ， 即 SurfaceHolder 对 象 。 该 方法 必须 在 
SurfaceHolder.Callback 的 surfaceCreated 方法 中 调用 。 
e startPreview: 开始 预览 。 该 方法 必须 在 setPreviewDisplay 方法 之 后 调用 。 
e unlock: 录像 时 需要 对 摄像 头 解锁 , 这样 摄像 头 才能 持续 录像 。 该 方法 必须 在 startPreview 
方法 之 后 调用 。 
e setDisplayOrientation: 设置 预览 的 角度 。Android 的 0 度 在 三 点 钟 的 水 平 位 置 ， 而 手机 屏 
幕 是 垂直 位 置 ， 从 水 平 位 置 到 垂直 位 置 需要 旋转 90 度 。 
e autoFocus: 设置 对 焦 事 件 。 参 数 自动 对 焦 接口 AutoFocusCallback 的 onAutoFocus 方法 在 
对 焦 完成 时 触发 ， 在 此 提示 用 户 对 焦 完 毕 可 以 拍照 了 。 
e takePicture: 开始 拍照 ,并 设置 拍照 相关 事件 。 第 一 个 参数 为 快门 回调 接口 ShutterCallback， 
它 的 onShutter 方 法 在 按 下 快门 时 触发 ,通常 可 在 此 播放 拍照 声音 ， 默 认为 “ 味 喀 ”一 声 ; 
第 二 个 参数 的 PictureCallback 表示 原始 图 像 的 回调 接口 ， 通 常 无 须 处 理 直 接 传 null; 第 
三 个 参数 的 PictureCallback 表示 JPG 图 像 的 回调 接口 ， 压 缩 后 的 图 像 数据 可 在 该 接口 中 
的 onPictureTaken 方法 中 获得 。 
e setZoomChangeListener: 设置 缩放 比例 变化 事件 .缩放 变化 监听 器 OnZoomChangeListener 
的 onZoomChange 方法 在 缩放 比例 发 生变 化 时 触发 。 
e setPreviewCallback: 设置 预览 回调 事件 ， 通 常 在 连 拍 时 调用 。 预 览 回 调 接口 
PreviewCallback 的 onPreviewFrame 方法 在 预览 图 像 发 生变 化 时 触发 。 
e stopPreview: 停止 预览 。 
e lock: 录像 完毕 对 摄像 头 加 锁 。 该 方法 在 stopPreview 方法 之 后 调用 。 
e release: 释放 摄像 头 。 因 为 摄像 头 不 能 重复 打开 ， 所 以 每 次 退出 拍照 时 都 要 释放 摄像 头 。 


结合 使 用 相机 工具 与 表面 视图 可 以 实现 单 拍 〈 每 次 只 拍 一 张 照片 ) 与 连 拍 〈 自动 连续 拍 
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摄 多 张 照片 ) 两 种 拍照 功能 。 其 中 ， 单 拍 功能 的 实现 代码 如 下 : 


public CameraView(Context context, AttributeSet attrs) { 
Super(context attrs); 
mContext = context; 
mHolder = getHolder(); 
mHolder.setFormat(PixelFormat. TRANSPARENT); 
mHolder.addCallback(mSurfaceCallback); 


private String mPhotoPath; 


// 外 部 调用 该 方法 获得 拍摄 照片 的 路 径 
public String getPhotoPath() { 

return mPhotoPath; 
j 


/外 部 调用 该 方法 进行 拍照 动作 
public void doTakePicture() í 
if(isPreviewing && mCamera!=null) í 
mCamera.takePicture(mShutterCallback, null, mPictureCallback); 


} 


// 快 门 按 下 的 回调 ， 在 这 里 可 以 设置 类 似 播放 “ 味 喀 ” 声 之 类 的 操作 。 默 认 的 是 “ 味 只 ” 
private ShutterCallback mShutterCallback = new ShutterCallback() í 
public void onShutter() í 
Log.d(TAG, "onShutter..."); 


h 


// 获 得 拍照 图 片 的 回调 。 在 此 保存 图 片 
private PictureCallback mPictureCallback = new PictureCallback() í 
public void onPictureTaken(byte[] data, Camera camera) í 
Log.d(TAG, "onPictureTaken..."); 
Bitmap raw = null; 
if(null != data) í 
raw = BitmapFactory.decodeByteArray(data, 0, data.length);// 将 data 解析 成 位 图 
mCamera.stopPreview(); 
isPreviewing = false; 
; 
Bitmap bitmap = BitmapUtil.getRotateBitmap(raw, (mCameraType— 
CAMERA BEHIND)?90:-90); 
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mPhotoPath = String.format("%s%s.jpg", BitmapUtil.getCachePath(mContext), 
Utils.getNowDateTime()); 
BitmapUtil.saveBitmap(mPhotoPath, bitmap, "jpg", 80); 
Log.d(TAG, "bitmap.size="+(bitmap.getByteCount()/1024)+"K"+", path="+mPhotoPath); 
uy { 
Thread.sleep(1000); 
} catch (InterruptedException e) í 
e.printStackTrace(); 
; 
// 再 次 进入 预览 
mCamera.startPreview(); 
isPreviewing = true; 


h 


// 预 览 界面 状态 变更 时 的 回调 
private SurfaceHolder.Callback mSurfaceCallback = new SurfaceHolder.Callback() í 
(@Override 
public void surfaceCreated(SurfaceHolder holder) í 
/ 当 预 览 视 图 创建 的 时 候 开 启 相机 
mCamera = Camera.open(mCameraType); 
try { 
J| 设置 预览 
mCamera.setPreviewDisplay(holder); 
mCameraSize = MetricsUtil.getCameraSize(mCamera.getParameters(), 
MetricsUtil.getSize(mContext)); 
Log.d(TAG, "width="+mCameraSize.x+", height-"4mCameraSize.y); 
Camera.Parameters parameters = mCamera.getParameters(); 
/ 设置 预览 大 小 
parameters.setPreviewSize(mCameraSize.x, mCameraSize.y); 
// 设置 图 片 保存 时 的 分 辨 率 大 小 
parameters.setPictureSize(mCameraSize.x, mCameraSize.y); 
J| 设置 格式 
parameters.setPictureFormat(ImageFormat.JPEG); 
/ 设置 自动 对 焦 。 前 置 摄像 头 似乎 无 法 自动 对 焦 
if (mCameraType == CameraView.CAMERA BEHIND) í 
parameters.setFocusMode(Camera.Parameters.FOCUS MODE AUTO); 
$ 
mCamera.setParameters(parameters); 
} catch (Exception e) í 
e.printStackTrace(); 
mCamera.release(); 
mCamera = null; 
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} 

return; 
p 
(&Override 


public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) í 
mCamera.setDisplayOrientation(90); 
mCamera.startPreview(); 
isPreviewing = true; 
mCamera.autoFocus(null); 
//setPreviewCallback 给 连 拍 使 用 
mCamera.setPreviewCallback(mPreviewCallback); 


@Override 

public void surfaceDestroyed(SurfaceHolder holder) { 
mCamera.setPreviewCallback(null); 
mCamera.stopPreview(); 
mCamera.release(); 
mCamera = null; 


h 
单 拍 的 效果 如 图 9-5 所 示 ， 每 次 从 拍照 页 面 返 回 时 都 展示 最 后 一 张 拍摄 的 照片 。 





Camera 拍 照 





后 置 摄像 头 拍照 前 置 摄 像 头 拍照 








图 9-5 使 用 Camera 单 拍 的 效果 图 
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实现 连 拍 功 能 要 先 调 用 setPreviewCallback 方法 设置 预览 回调 接口 ， 然 后 实现 


= 














调 接口 中 


的 onPreviewFrame 方法 ， 在 该 方法 中 获得 并 保存 每 张 预览 照片 。 连 拍 功能 的 实现 代码 如 下 : 


private boolean bShooting = false; 
private int shooting num = 0; 
private ArrayList<String> mShootingArray; 


// 外 部 调用 该 方法 获得 连 拍照 片 的 路 径 

public ArrayList<String> getShootingList() { 
Log.d(TAG, "mShootingArray.size()="+mShootingArray.size()); 
return mShootingArray; 


// 外 部 调用 该 方法 进行 连 拍 动作 

public void doTakeShooting() { 
mShootingArray = new ArrayList<String>(); 
bShooting = true; 
shooting_num = 0; 


private PreviewCallback mPreviewCallback = new PreviewCallback() í 
@Override 
public void onPreviewFrame(byte[] data, Camera camera) { 
Log.d(TAG, "onPreviewFrame bShooting="+bShooting+", shooting num-" 
«shooting num); 
if (!bShooting) í 
return; 
j 
Camera.Parameters parameters = camera.getParameters(); 
int imageFormat = parameters.getPreviewFormat(); 
int w = parameters.getPreviewSize().width; 
int h = parameters.getPreviewSize().height; 
Rect rect = new Rect(0, 0, w, h); 
Yuvlmage yuvlmg = new Yuvlmage(data, imageFormat, w, h, null); 
ty { 
ByteArrayOutputStream bos = new ByteArrayOutputStream(); 
yuvImg.compressToJpeg(rect, 80, bos); 
Bitmap raw = BitmapFactory.decodeByteArray(bos.toByteA rray(), 0, bos.size()); 
Bitmap bitmap = BitmapUtil.getRotateBitmap(raw, (mCameraType-— 
CAMERA BEHIND)?90:-90); 
String path = String.format("%s%s.jpg", BitmapUtil.getCachePath(mContext), 
Utils.getNowDateTimeFull()); 
BitmapUtil.saveBitmap(path, bitmap, "jpg", 80); 
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Log.d(TAG, "bitmap.size-"(bitmap.getByteCount()/1024)-"K"", path="+path); 
// 再 次 进入 预览 
camera.startPreview(); 
shooting num; 
m$ShootingArray.add(path); 
if (shooting num > 8) { // 每 次 连 拍 9 张 
bShooting = false; 
} 
} catch (Exception e) { 
e.printStackTrace(); 
; 


k 
连 拍 的 效果 如 图 9-6 所 示 ， 每 次 从 拍照 页 面 返回 时 都 展示 最 后 一 组 连 拍 的 照片 合集 。 


device 


后 置 摄像 头 拍照 前 置 摄像 头 拍 昭 





图 9-6 使 用 Camera 连 拍 的 效果 图 
9.43 ”纹理 视图 TextureView 


表面 视图 SurfaceView 在 一 般 情况 下 足够 使 用 了 , 但 是 有 一 些 限制 。 因 为 表面 视图 不 是 通 
过 onDraw 方法 和 dispatchDraw 方法 进行 绘图 ， 所 以 无 法 使 用 View 的 基本 视图 方法 。 例 如 ， 
各 种 视图 变化 方法 均 无 法 奏效 ， 包 括 透 明度 变化 方法 setAlpha、 平 移 方法 setTranslation、 缩 放 
方法 setScale、 旋 转 方 法 setRotation 等 ， 甚 至 连 最 基础 的 背景 图 设置 方法 setBackground 都 失 
效 了 。 

为 了 解决 表面 视图 的 不 足 之 处 ，Android 在 4.0 之 后 引入 了 纹理 视图 TextureView. 与 表面 
视图 相 比 , 纹理 视图 并 没有 创建 一 个 单独 的 绘图 表面 用 来 绘制 , 可 以 像 普 通 视 图 一 样 执行 变换 
操作 ， 也 可 以 正常 设置 背景 图 。 
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下 面 是 TextureView 的 常用 方法 。 


lockCanvas: 锁定 并 获取 画布 。 

unlockCanvasAndPost: 解锁 并 刷新 画布 。 

e setSurfaceTextureListener: 设置 表面 纹理 的 监听 器 。 该 方法 相当 于 SurfaceHolder 的 
addCallback 方法 , 用 来 监控 表面 纹理 的 状态 变化 事件 .方法 参数 为 SurfaceTextureListener 
监听 器 对 象 ， 需 重 写 以 下 4 个 方法 。 


> onSurfaceTextureAvailable: 在 表面 纹理 可 用 时 触发 ， 可 在 此 进行 打开 相机 等 操作 。 
> onSurfaceTextureSizeChanged: 在 表面 纹理 尺寸 变化 时 触发 。 

> onSurfaceTextureDestroyed: 在 表面 纹理 销毁 时 触发 。 

» onSurfaceTextureUpdated: 在 表面 纹理 更 新 时 触发 。 


e isAvailable: 判断 表面 纹理 是 否 可 用 。 
e getSurfaceTexture: 获取 表面 纹理 。 


下 面 通过 具体 例子 说 明 纹 理 视图 与 表面 视图 的 区 别 。 图 9-7 所 示 为 纹理 视图 的 透明 度 值 为 
0.2, 扇形 看 起 来 颜色 较 浅 ; 图 9-8 所 示 为 纹理 视图 的 透明 值 增 大 为 0.8， 此 时 扇形 的 颜色 较 深 。 








转动 转动 
0.2 08 
9-7 透明 度 为 0.2 的 纹理 视图 图 9-8 透明 度 为 0.8 的 纹理 视图 


纹理 视图 和 表面 视图 的 默认 背景 都 是 黑色 ， 要 想 把 背景 改 为 白色 ，TextureView 可 以 直接 
调用 背景 设置 方法 setBackground， 而 SurfaceView 要 调用 以 下 代码 才能 把 背景 洗 白 : 
setZOrderOnTop(true); 
mHolder.setFormat(PixelFormat. TRANSLUCENT); 


9.1.4 使 用 Camera 2 拍照 


如 同 纹理 视图 是 表面 视图 的 升级 版 那样 , Android 在 5.0 之 后 推出 了 Camera 的 升级 版 一 一 
camera 2。 按 照 Android 的 官方 说 明 ，camera 2 支持 以 下 5 点 新 特性 : 


(1) 支持 每 秒 30 帧 的 全 高 清 连 拍 。 
D 支持 在 每 帧 之 间 使 用 不 同 的 设置 。 
(3) 支持 原生 格式 的 图 像 输出 。 
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(4) 支持 零 延 迟 快门 和 电影 速 拍 。 

(5) 支持 相机 在 其 他 方面 的 手动 控制 ， 比 如 设置 噪音 消除 的 级 别 。 

camera2 在 架构 上 做 了 大 幅 改造 ， 原 先 的 Camera 类 被 拆 分 为 多 个 管理 类 ， 主 要 有 相机 管 
理 器 CameraManager、 相 机 设备 CameraDevice、 相 机 拍照 会 话 CameraCaptureSession, 、 图 像 读 
取 器 ImageReader。 





1. 相机 管理 器 CameraManager 


相机 管理 器 用 于 获取 可 用 摄像 头 列表 打开 摄像 头等 ,对象 从 系统 服务 CAMERA SERVICE 
获取 。 常 用 方法 说 明 如 下 : 


e getCameraldList: 获取 相机 列表 。 通 常 返 回 两 条 记录 ， 一 条 是 后 置 摄像 头 ， 另 一 条 是 前 
置 摄像 头 。 
e getCameraCharacteristics: 获取 相机 的 参数 信息 。 包 括 相机 的 支持 级 别 、 照 片 的 尺寸 等 。 


因为 camera2 是 Android5.0 之 后 才 有 的 新 特性 , 不 少 手 机 还 不 能 很 好 的 支持 , 所 以 最 好 先 
检查 相机 的 支持 级 别 ， 如 果 返 回 值 为 INFO SUPPORTED HARDWARE LEVEL LEGACY, 
就 不 建议 在 App 中 使 用 camera2 的 相关 技术 。 检 查 相 机 支持 级 别 的 代码 如 下 : 

CameraCharacteristics cc = cm.getCameraCharacteristics(cameraid); 

// CameraCharacteristics.INFO SUPPORTED HARDWARE LEVEL FULL 表示 完全 支持 

// CameraCharacteristics.INFO SUPPORTED HARDWARE LEVEL LIMITED 表示 有 限 支 持 
// CameraCharacteristics.INFO SUPPORTED HARDWARE LEVEL LEGACY 表示 遗留 的 
int level = cc.get(CameraCharacteristics. |INFO SUPPORTED HARDWARE. LEVEL); 


e openCamera: 打开 指定 摄像 头 ， 第 一 个 参数 为 指定 摄像 头 的 id， 第 二 个 参数 为 设备 状态 
监听 器 ， 该 监听 器 需 实 现 接口 CameraDevice.StateCallback 的 onOpened 方法 (方法 内 部 
再 调用 CameraDevice 对 象 的 createCaptureRequest 方法 ) 。 

o setTorchMode: 在 不 打开 摄像 头 的 情况 下 ， 开启 或 关闭 闪光 灯 。 为 true 表示 开启 闪光 灯 ， 
为 false 表示 关闭 闪光 灯 。 

2. 相机 设备 CameraDevice 

相机 设备 用 于 创建 拍照 请 求 、 添 加 预览 界面 、 创 建 拍照 会 话 等 。 常 用 方法 说 明 如 下 : 

e createCaptureRequest: 创建 拍照 请 求 ， 第 二 个 参数 为 会 话 状态 的 监听 器 ， 该 监听 器 需 实 
现 会 话 状态 回调 接口 CameraCaptureSession.StateCallback 的 onConfigured 方法 (方法 内 
部 再 调用 CameraCaptureSession 对 象 的 setRepeatingRequest 方法 ， 将 预览 影像 输出 到 屏 


幕 ) 。createCaptureRequest 方法 返回 一 个 CaptureRequest 的 预览 对 象 。 
e close: 关闭 相机 。 


3. 相机 拍照 会 话 CameraCaptureSession 


相机 拍照 会 话 用 于 设置 单 拍 会 话 〈 每 次 只 拍 一 张 照 片 ) 、 连 拍 会 话 〈 自 动 连续 拍摄 多 张 
照片 ) 等 。 常 用 方法 说 明 如 下 : 


* 310* 
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4. 


getDevice: 获得 该 会 话 的 相机 设备 对 象 。 

capture: 拍照 并 输出 到 指定 目标 。 输 出 目标 为 CaptureRequest 对 象 时 ， 表 示 显 示 在 屏幕 
上 ; 输出 目标 为 ImageReader 对 象 时 ， 表 示 要 保存 照片 。 

setRepeatingRequest: 设置 连 拍 请 求 并 输出 到 指定 目标 。 输 出 目标 为 CaptureRequest 对 象 
时 ， 表 示 显 示 在 屏幕 上 ; 输出 目标 为 ImageReader 对 象 时 ， 表 示 要 保存 照片 。 
stopRepeating: 停止 连 拍 。 


图 像 读 取 器 ImageReader 


图 像 读 取 器 用 于 获取 并 保存 照片 信息 ， 一 旦 有 图 像 数据 生成 ， 立 刻 触 发 onImageA vailable 
方法 。 常 用 方法 说 明 如 下 : 


getSurface: 获得 图 像 读 取 的 表面 对 象 。 
setOnImageAvailableListener: 设置 图 像 数据 的 可 用 监听 器 。 该 监听 器 需 实现 接口 
ImageReader.OnImageAvailableListener 的 onImageAvailable 方法 。 


这 几 个 相机 类 之 间 的 调用 流程 比 原来 的 Camera 类 要 复杂 许多 ， 详 细 的 文字 说 明 反而 不 容 
易 理 解 ， 限 于 篇 幅 这 里 就 不 贴 出 大 段 的 调用 代码 了 ， 读 者 可 翻阅 本 书 下 载 资源 里 的 camera 2 
调用 模板 ， 一 边 阅 读 代 码 、 一 边 熟悉 调用 流程 。 

使 用 camera 2 拍照 的 效果 如 图 9-9 和 图 9-10 所 示 。 其 中 ， 图 9-9 所 示 为 单 拍 时 拍摄 的 最 
后 一 张 照片 ， 图 9-10 所 示 为 连 拍 时 拍摄 的 最 后 一 组 照片 合集 。 


新 版 Camera2 拍 照 新 版 camera2 拍 昭 


T 














ERRPAAR  MEARAHE 后 这 提 像 头 拍照 MENHAR 
图 9-9 使 用 Camera2 单 拍 的 效果 图 图 9-10 使 用 Camera2 连 拍 的 效果 图 
9.2 2 wW JA 


本 节 介 绍 以 麦克 风 为 基础 的 声效 应 用 , 首先 简要 说 明 拖 动 条 SeekBar 的 用 法 ,描述 如 何 使 


ETE 
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用 拖 动 条 调整 各 类 音量 大 小 ; 然后 介绍 媒体 录制 器 MediaRecorder 与 媒体 播放 器 MediaPlayer， 
并 演示 通过 媒体 录制 器 和 媒体 播放 器 完成 录音 和 播音 功能 ; 最 后 结合 9.1 节 的 相机 与 表面 视图 
知识 演示 通过 媒体 录制 器 和 媒体 播放 器 完成 录像 和 放映 功能 。 


9.221 拖 动 条 SeekBar 


拖 动 条 SeekBar 继承 自 进度 条 ProcessBar， 与 进度 条 的 不 同 之 处 在 于 : 进度 条 只 能 在 代码 
中 修改 进度 ， 不 能 由 用 户 改变 进度 值 ; 拖 动 条 不 但 可 以 在 代码 中 修改 进度 , 还 可 以 由 用 户 在 屏 
幕 上 通过 拖 动 操作 改变 进度 。 拖 动 条 可 用 于 音频 和 视频 播放 时 的 进度 条 , 用 户 通过 拖 动 操作 控 
制 播放 器 快 进 或 快 退 到 指定 位 置 ， 然 后 从 新 位 置 开 始 播放 音频 或 视频 。 除 此 之 外 ， 拖 动 条 还 可 
调节 各 种 音量 大 小 、 调 节 屏 幕 亮度 、 调 节 字 体 大 小 等 。 
下 面 是 SeekBar 新 增加 的 4 个 方法 。 
setThumb: 设置 当前 进度 位 置 的 图 标 。 
setThumbOffset: 设置 当前 进度 图 标的 偏 移 量 。 
setKeyProgressIncrement: 设置 使 用 方向 键 更 改进 度 时 每 次 的 增加 值 。 
setOnSeekBarChangeListener: 设置 拖 动 变化 事件 。 需 实现 监听 器 OnSeekBarChangeListener 
的 3 个 方法 。 
> onProgressChanged: 在 进度 变化 时 触发 。 第 3 个 参数 表示 是 否 来 自用 户 , 为 true 表示 用 户 
拖 动 ， 为 false 表示 代码 修改 进度 。 
> onStartTrackingTouch: 开始 拖 动 时 触发 。 
> onStopTrackingTouch: 结束 拖 动 时 触发 。 一 般 在 该 方法 中 添加 用 户 拖 动 的 处 理 逻 辑 。 
下 面 是 操作 拖 动 条 的 代码 : 
public class SeekbarActivity extends AppCompatActivity implements OnSeekBarChangeListener í 


private SeekBar sb. progress; 
private TextView tv progress; 





(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity seekbar); 
tv progress = (TextView) findViewByld(R.id.tv progress); 
sb progress = (SeekBar) findViewByld(R.id.sb progress); 
sb progress.setOnSeekBarChangeL istener(this); 
sb progress.setProgress(50); 

} 


@Override 

public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) { 
String desc = "当前 进度 为 : "+seekBar.getProgress()+"， 最 大 进度 为 "+HseekBargetMax(); 
tv progress.setText(desc); 
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j 


@Override 
public void onStartTrackingTouch(SeekBar seekBar) { 
} 


(@Override 
public void onStopTrackingTouch(SeekBar seekBar) í 
h 

i 


上 述 代码 的 界面 效果 如 图 9-11 和 图 9-12 所 示 。 其 中 ， 图 9-11 所 示 为 拖 动 前 的 界面 ， 进 
度 值 为 50; 图 9-12 所 示 为 向 右 拖 动 后 的 界面 ， 进 度 值 为 73。 


device device 





— o MM. 
当前 进度 为 : 50, 最 大 进度 为 100 当前 进度 为 : 73, 最 大 进度 为 100 


图 9-11 拖 动 前 的 SeekBar 图 9-12 拖 动 后 的 SeekBar 
922 ”音量 控制 
Android 只 有 一 个 麦克 风 ， 却 有 6 类 铃 音 ， 分 别 是 通话 音 、 系 统 音 、 铃 音 、 媒 体 音 、 闵 钟 
音 、 通 知音 ， 铃 音 类 型 的 取 值 说 明 见 表 9-2。 
表 9-2 铃 音 类 型 的 取 值 说 明 




















AudioManager 类 的 铃 音 类 型 铃 音 名 称 说 明 

STREAM VOICE CALL 通话 音 

STREAM SYSTEM 系统 音 

STREAM_RING 铃 音 来 电 与 收 短信 的 铃声 
STREAM_MUSIC 媒体 音 音频 、 视 频 、 游 戏 等 的 声音 
STREAM ALARM eE 

STREAM_NOTIFICATION 通知 音 








管理 这 些 铃 声音 量 的 工具 是 AudioManager， 对 象 从 系统 服务 AUDIO_SERVICE 中 获取 。 
下 面 是 AudioManager 的 常用 方法 。 


e getStreamMaxVolume: 获取 指定 类 型 铃声 的 最 大 音量 。 
e getStreamVolume: 获取 指定 类 型 铃声 的 当前 音量 。 
e getRingerMode: 获取 指定 类 型 铃声 的 响 铃 模式 。 响 铃 模式 的 取 值 说 明 见 表 9-3。 
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表 9-3 ” 响 铃 模式 的 取 值 说 明 


AudioManager 类 的 响 铃 模式 说 明 





RINGER MODE NORMAL 正常 





RINGER_MODE_SILENT 静音 





震动 





RINGER MODE _ VIBRATE 


e setStreamVolume: 设置 指定 类 型 铃声 的 当前 音量 。 


e setRingerMode: 设置 指定 类 型 铃声 的 响 铃 模式 。 响 铃 模式 的 取 值 说 明 见 表 9-3。 

e adjustStreamVolume: 调整 指定 类 型 铃声 的 当前 音量 。 第 一 个 参数 是 铃声 类 型 ; 第 二 个 参 
数 是 调整 方向 ， 音 量 调整 方向 的 取 值 说 明 见 表 9-4; 第 三 个 参数 表示 调整 时 的 附加 动作 ， 
一 般 使 用 FLAG PLAY SOUND 表示 调整 时 提示 一 个 铃声 。 


表 9-4 音量 调整 方向 的 取 值 说 明 





AudioManager 类 的 音量 调整 方向 说 明 

ADJUST RAISE 调 大 一 级 
ADJUST LOWER 调 小 一 级 
ADJUST SAME 保持 不 变 





ADJUST MUTE 静音 





ADJUST UNMUTE 取消 静音 





ADJUST TOGGLE MUTE 





上 面 的 setStreamVolume 和 adjustStreamVolume 两 
个 方法 都 能 用 来 设置 音量 ， 不 同 的 是 setStreamVolume 
直接 将 音量 调整 到 目标 值 ， 通 常 与 拖 动 条 配合 使 用 ， 而 
adjustStreamVolume 是 以 当前 音量 为 基础 ， 然 后 调 大 、 
调 小 或 调 静 音 。 

音量 调整 的 效果 如 图 9-13 所 示 , 这 个 设置 页 面 不 但 
允许 直接 调整 音量 到 目标 值 ， 还 允许 逐 级 调 大 或 逐 级 调 
小 音量 。 


923 ”录音 与 播音 


Android 中 没有 单独 操作 麦克 风 的 工具 类 ， 如 果 要 
录音 就 用 媒体 录制 器 MediaRecorder, 如 果 要 播音 就 用 媒 
体 播放 器 MediaPlayer 类 。 下 面 分 别 进行 介绍 。 


1. 媒体 录制 器 MediaRecorder 


静音 取 反 ， 即 原来 不 是 静音 就 设置 静音 ， 原 来 是 静音 就 取消 静音 





调节 通话 音量 
——— S 


调节 系统 音量 
——Fcn MÀS 


调节 铃声 音量 
一 全 


调节 音乐 音量 
pe 和 


调节 闹钟 音量 





调节 通知 音量 
—————————_— 





9-13. 各 种 铃 音 的 音量 调整 界面 


MediaRecorder 是 Android 自 带 的 音频 和 视频 录制 工具 ， 它 通过 操纵 摄像 头 和 麦克 风 完 成 


媒体 录制 ， 既 可 录制 视频 ， 又 可 单独 录制 音频 。 


下 面 是 MediaRecorder 的 常用 方法 〈 录 音 与 录像 通用 ) 。 
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reset: 重 置 录 制 资源 。 

prepare: 准备 录制 。 

start: 开始 录制 。 

stop: 结束 录制 。 

release: 释放 录制 资源 。 

setOnErrorListener: 设置 错误 监听 器 。 可 监听 服务 器 异常 和 未 知 错误 的 事件 。 需 要 实现 
接口 MediaRecorder.OnErrorListener 的 onError 方法 。 

setOnInfoListener: 设置 信息 监听 器 。 可 监听 录制 结束 事件 ， 包 括 达到 录制 时 长 或 达到 录 
制 大 小 。 需 要 实现 接口 MediaRecorder.OnInfoListener 的 onlnfo 方法 。 

setMaxDuration: 设置 可 录制 的 最 大 时 长 ， 单 位 毫秒 。 

setMaxFileSize: 设置 可 录制 的 最 大 文件 大 小 ， 单 位 字 节 。 

setOutputFile: 设置 输出 文件 的 路 径 。 


下 面 是 MediaRecorder 用 于 音频 录制 的 方法 〈 当 然 录像 时 要 一 起 录音 ) 。 


setAudioSource: 设置 音频 来 源 。 一 般 使 用 麦克 风 AudioSource.MIC. 
setOutputFormat: 设置 媒体 输出 格式 。 媒体 输 出 格式 的 取 值 说 明 见 表 9-5. 


表 9-5 媒体 输出 格式 的 取 值 说 明 











OutputFormat 类 的 输出 格式 格式 分 类 格式 说 明 

AMR_NB 音频 Kausai 

AMR_WB 音频 宽带 格式 

AAC_ADTS 音频 高 级 的 音频 传输 流 格式 
MPEG 4 视频 MPEG4 格式 

THREE GPP 视频 3GP 格式 








setAudioEncoder: 设置 音频 编码 器 。 音 频 编 码 器 的 取 值 说 明 见 表 9-6。 注 意 : 该 方法 应 在 
setOutputFormat 方法 之 后 执行 否则 会 出 现 setAudioEncoder called in an invalid state(2) 的 
异常 。 


表 9-6 ”音频 编码 器 的 取 值 说 明 




















AudioEncoder 类 的 音频 编码 器 说 明 

AMR NB 窄带 编码 

AMR_WB 宽带 编码 

AAC 低 复杂 度 的 高 级 编码 
HE AAC 高 效率 的 高 级 编码 
AAC ELD 高 效率 的 高 级 编码 


e setAudioSamplingRate: 设置 音频 的 采样 率 ， 单 位 千 幸 效 (kHz) 。AMR_NB 格式 默认 


8kHz, AMR_WB 格式 默认 16kHz. 


e setAudioChannels: 设置 音频 的 声 道 数 。1 表示 单 声 道 ，2 表示 双 声 道 。 
e setAudioEncodingBitRate: 设置 音频 每 秒 录制 的 字 节 数 。 数 值 越 大 音频 越 清 晰 。 
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下 面 是 使 用 MediaRecorder 实现 简单 音频 录制 器 的 代码 : 


public class AudioRecorder extends LinearLayout implements OnErrorListener, 
OnlnfoListener, OnCheckedChangeL istener í 
private MediaRecorder mMediaRecorder; 
private ProgressBar pb record; 
private CheckBox ck record; 
private Timer mTimer; // 计时 器 
private int mRecordMaxTime = 10; // 一 次 录音 最 长 时 间 
private int mTimeCount; // 时 间 计 数 
private String mRecordFilePath; 


public AudioRecorder(Context context) { 
this(context, null); 


public AudioRecorder(Context context, AttributeSet attrs) { 
this(context, attrs, 0); 


public AudioRecorder(Context context, AttributeSet attrs, int defStyle) { 
super(context, attrs, defStyle); 
LayoutInflater.from(context).inflate(R.layout.audio_recorder, this); 
pb record = (ProgressBar) findViewById(R.id.pb_record); 
pb record.setMax(mRecordMax Time); 
ck record = (CheckBox) find ViewById(R.id.ck record); 
ck record.setOnCheckedChangeListener(this); 


/ 开始 录音 
public void start() í 
mRecordFilePath = MediaUtil.getRecordFilePath("RecordAudio", ".amr"); 
ty ( 
initRecord(); 
mTimeCount = 0; 
mTimer = new Timer(); 
mTimer.schedule(new TimerTask() í 
(@Override 
public void run() í 
pb_record.setProgressímTimeCount++); 
; 
3. 0, 1000); 
} catch (Exception e) í 
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e.printStackTrace(); 


/ 停止 录音 
public void stop() í 
if (mOnRecordFinishListener != null) í 
mOnREecordFinishListener.onRecordFinish(); 
$ 
stopRecord(); 
releaseRecord(); 


/ 获得 最 近 一 次 的 录音 文件 路 径 
public String getRecordFilePath() { 
return mRecordFilePath; 


private void initRecord() { 

mMediaRecorder = new MediaRecorder(); 
mMediaRecorder.setOnErrorListener(this); 
mMediaRecorder.setOnInfoListener(this); 
mMediaRecorder.setAudioSource(AudioSource.MIC); // 音频 源 
mMediaRecorder.setOutputFormat(OutputFormat.AMR_NB); 
mMediaRecorder.setAudioEncoder(AudioEncoder.AMR_NB); // 音频 格式 
mMediaRecorder.setMaxDuration(10 * 1000); // 设置 录制 时 长 
mMediaRecorder.setOutputFile(mRecordFilePath); 
try ( 

mMediaRecorder.prepare(); 

mMediaRecorder.start(); 
} catch (Exception e) í 

e.printStackTrace(); 


private void stopRecord() í 

pb record.setProgress(0); 

if (mTimer != null) í 
mTimer.cancel(); 

; 

if (mMediaRecorder != null) í 
mMediaRecorder.setOnErrorListener(null); 
mMediaRecorder.setPreviewDisplay(null); 
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uy i 
mMediaRecorder.stop(); 


} catch (Exception e) í 
e.printStackTrace(); 


private void releaseRecord() í 
if (mMediaRecorder != null) í 
mMediaRecorder.setOnErrorListener(null); 
mMediaRecorder.release(); 
mMediaRecorder = null; 


private OnRecordFinishListener mOnRecordFinishListener; / 录制 完成 回调 接口 
public interface OnRecordFinishListener í 
public void onRecordFinish(); 


public void setOnRecordFinishListener(OnRecordFinishListener listener) í 
mOnRecordFinishListener = listener; 


(@Override 
public void onError(MediaRecorder mr, int what, int extra) í 
if (mr != null) í 
mr.reset(); 


@Override 
public void onInfo(MediaRecorder mr, int what, int extra) { 
if (what == MediaRecorder. MEDIA RECORDER INFO MAX DURATION REACHED 
|| what — MediaRecorder MEDIA RECORDER INFO MAX FILESIZE REACHED) í 
ck record.setChecked( false); 


@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (buttonView.getId() = R.id.ck record) í 
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j 


if (isChecked = true) í 
ck record setText(" 停 止 录制 ”); 
start(); 

1 else í 
ck_record.setText(" 开 始 录制 "); 
stop(); 


另外 ， 注 意 录音 与 录像 需要 在 AndroidManifest.xml 中 添加 权限 (录制 操作 通常 会 保存 媒 
体 文件 ， 也 就 是 操作 SD 卡 ， 所 以 需要 加 上 SD 卡 的 读 写 权限 ) : 


<!-- 录像 /录音 -> 

<uses-permission android:name="android.permission.CAMERA" /> 

<uses-permission android:name="android.permission.RECORD _ VIDEO"/> 

<uses-permission android:name="android.permission.RECORD AUDIO" /> 

<l-- SD 卡 -> 

<uses-permission android:name-"android.permission. WRITE EXTERNAL STORAGE" /> 
«uses-permission android:name-"android.permission.READ EXTERNAL STORAGE" /> 
«uses-permission android:name-"android.permission MOUNT UNMOUNT FILESYSTEMS" > 


2. 媒体 播放 器 MediaPlayer 
MediaPlayer 是 Android 自 带 的 音频 和 视频 播放 器 , 可 用 于 播放 MediaRecorder 录制 的 媒体 
文件 ， 包 括 表 9-5 所 示 的 文件 格式 ， 以 及 MP3、WAV、MID、0OGG 等 音频 文件 。 
下 面 是 MediaPlayer 的 常用 方法 (播音 与 放映 通用 〉。 


reset: 重 置 播放 器 。 

prepare: 准备 播放 。 

start: 开始 播放 。 

pause: 暂停 播放 。 

stop: 停止 播放 。 

setOnPreparedListener: 设置 准备 播放 监听 器 。 需 要 实现 接口 MediaPlayer.OnPreparedListener 
的 onPrepared 方法 。 

setOnCompletionListener: 设置 结束 播放 监听 器 .需要 实现 接口 MediaPlayer.OnCompletion- 
Listener 的 onCompletion 方法 。 

setOnSeekCompleteListener: 设置 播放 拖 动 监听 器 。 需 要 实现 接口 MediaPlayer.OnSeek- 
CompleteListener 的 onSeekComplete 方法 。 

create: 创建 指定 Uri 的 播放 器 。 

setDataSource: 设置 播放 数据 来 源 的 文件 路 径 。create 与 setDataSource 两 个 方法 只 需 调 
H—^. 
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setVolume: 设置 音量 。 两 个 参数 分 别 是 左 声 道 和 右 声 道 的 音量 ， 取 值 在 0~ 1 之 问 。 
setAudioStreamType: 设置 音频 流 的 类 型 。 音 频 流 类 型 的 取 值 说 明 见 表 9-2。 
setLooping: 设置 是 否 循环 播放 。true 表示 循环 播放 ，false 表示 只 播放 一 次 。 
isPlaying: 判断 是 否 正 在 播放 。 

seekTo: 拖 动 播放 进度 到 指定 位 置 。 该 方法 可 与 拖 动 条 SeekBar 配合 使 用 。 
getCurrentPosition: 获取 当前 播放 进度 所 在 的 位 置 。 

getDuration: 获取 播放 时 长 ， 单 位 毫秒 。 

下 面 是 使 用 MediaPlayer 实现 简单 音频 播放 器 的 代码 : 

public class AudioPlayer extends LinearLayout implements OnCompletionListener, OnCheckedChangeListener { 
private static final String TAG = "AudioPlayer"; 


private MediaPlayer mMediaPlayer; 
private ProgressBar pb. play; 


private CheckBox ck play; 
private Timer mTimer; // 计时 器 
private String mAudioPath; 
private boolean bFinish — true; 


public AudioPlayer(Context context) í 
this(context, null); 


public AudioPlayer(Context context, AttributeSet attrs) { 
this(context, attrs, 0); 


public AudioPlayer(Context context, AttributeSet attrs, int defStyle) í 
super(context, attrs, defStyle); 
LayoutInflater.from(context).inflate(R.layout.audio player, this); 
pb play = (ProgressBar) findViewByld(R.id.pb play); 
ck play = (CheckBox) findViewById(R.id.ck play); 
ck play.setOnCheckedChangeListener(this ); 

} 


/ 初始 化 音频 文件 路 径 与 播放 器 

public void init(String path) í 
mAudioPath = path; 
ck play.setEnabled(true); 
ck play.setTextColor(Color.BLACK); 
mMediaPlayer = new MediaPlayer(); 
mMediaPlayer.setOnCompletionListener(this); 
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private void play() í 
try { 
mMediaPlayer.reset(); 
mMediaPlayer.setAudioStreamType( AudioManager.STREAM MUSIC); 
Log.d(TAG, "audio path = " + mAudioPath); 
// 录制 完毕 要 等 一 秒 钟 再 调用 setDataSource 方法 ， 因 为 此 时 可 能 尚未 完成 写 入 
mMediaPlayer.setDataSource(mAudioPath); 
mMediaPlayer.prepare(); 
mMediaPlayer.start(); 
pb_play.setMax(mMediaPlayer.getDuration()); 
mTimer = new Timer(); 
mTimer.schedule(new TimerTask() í 
@Override 
public void run() í 
pb_play.setProgress(mMediaPlayer.getCurrentPosition()); 


j 
}, 0, 1000); 
} catch (Exception e) í 
e.printStackTrace(); 
J 
; 
(@Override 
public void onCompletion(MediaPlayer mp) í 
bFinish = true; 
ck play.set Checked(false); 
if (mTimer != null) í 
mTimer.cancel); 
; 
j 
(a Override 


public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) í 
if (buttonView.getId() = R.id.ck play) í 
if (iSChecked = true) í 

ck_play.setText(" 暂 停 播放 "); 

if (bFinish = true) í 
play(); 

yelse í 
mMediaPlayer.start(); 

; 

bFinish — false; 
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} else í 
ck_play.setText(" 开 始 播放 "); 
mMediaPlayer.pause(); 


; 

由 于 音频 本 身 没有 对 应 的 界面 ， 因 此 只 能 使 用 进度 条 间接 表达 音频 录制 与 播放 进度 。 录 
音 与 播音 的 效果 如 图 9-14 和 图 9-15 所 示 。 其 中 ， 图 9-14 表示 当前 正在 录音 ， 图 9-15 表示 当 
前 正在 播音 。 


device device 


停止 录制 


开始 播放 





图 9-14 正在 录音 的 界面 图 9-15 正在 播音 的 界面 
924 ”录像 与 放映 


Android 录制 视频 与 录音 一 样 都 使 用 媒体 录制 器 MediaRecorder， 播 放 视 频 与 播音 一 样 都 
使 用 媒体 播放 器 MediaPlayer。MediaRecorder 和 MediaPlayer 处 理 音频 与 视频 的 大 部 分 方法 相 
同 , 不 同 的 是 录像 与 放映 多 出 了 对 摄像 头 、 表 面 视 图 以 及 视频 进行 编码 和 解码 的 操作 。 下 面 分 
别 介绍 MediaRecorder 和 MediaPlayer 对 视频 的 额外 处 理 部 分 。 


1. 媒体 录制 器 MediaRecorder (录像 部 分 ) 
下 面 是 MediaRecorder 录制 视频 的 专用 方法 (如 果 只 是 录音 ， 就 不 需要 这 些 方法 ) 。 


e setCamera: 设置 相机 对 象 。 
e setPreviewDisplay: 设置 预览 界面 。 预 览 界 面 对 象 可 通过 SurfaceHolder 对 象 的 getSurface 


方法 获得 。 
e setOrientationHint: 设置 预览 的 角度 。 跟 拍照 一 样 设置 为 90， 表 示 界 面 从 水 平方 向 到 垂 
直方 向 旋转 90 度 。 


e setVideoSource: 设置 视频 来 源 。 一 般 使 用 VideoSource.CAMERA 表示 摄像 头 。 

e setOutputFormat: 设置 媒体 输出 格式 。 媒 体 输出 格式 的 取 值 说 明 见 表 9-5. 

e setVideoEncoder: 设置 视频 编码 器 。 一 般 使 用 VideoEncoder.MPEG 4 SP 表示 MPEG4 
编码 。 


o 该 方法 要 在 setOutputFormat 方法 之 后 调用 ， 否 则 会 报错 javalang.IllegalStateException 。 
注 意 
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e setVideoSize: 设置 视频 的 分 辨 率 。 

e setVideoFrameRate: 设置 视频 每 秒 录制 的 帧 数 。 越 大 视频 越 连贯 ， 当 然 最 终生 成 的 视频 
文件 也 越 大 。 

e setVideoEncodingBitRate : 设置 视频 每 秒 录制 的 字 节 数 。 越 大 视频 越 清晰 ， 
setVideoFrameRate 与 setVideoEncodingBitRate 设置 一 个 即 可 。 


录像 与 录音 相 比 ， 在 界面 上 增加 了 SurfaceView， 代 码 增加 了 对 SurfaceHolder 与 Camera 
的 处 理 。 下 面 是 增加 的 代码 片段 : 


private SurfaceHolder mHolder; 
private SurfaceHolder.Callback mSurfaceCallback = new SurfaceHolder.Callback() í 
(@Override 
public void surfaceCreated(SurfaceHolder holder) í 
initCamera(); 


J 


@Override 
public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { 
J 


@Override 
public void surfaceDestroyed(SurfaceHolder holder) { 
freeCamera(); 
j 
h 


private void initCamera() í 
if (mCamera != null) í 
freeCamera(); 
J 
try { 


mCamera = Camera.open(); 
mCamera.setDisplayOrientation(90); 
mCamera.setPreviewDisplay(mHolder); 
mCamera.startPreview(); 
mCamera.unlock(); 

} catch (Exception e) í 
e.printStackTrace(); 
freeCamera(); 


j 


private void freeCamera() í 
if (mCamera != null) í 


mCamera.stopPreview(); 
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mCamera.lock(); 
mCamera.release(); 
mCamera = null; 


j 


private void initRecord() í 
mHolder = sv. record.getHolder(); 
mHolder.addCallback(mSurfaceCallback); 


j 


private void startRecord() í 
mMediaRecorder = new MediaRecorder(); 
mMediaRecorder.setCamera(mCamera); 
mMediaRecorder.setOnErrorListener(this ); 
mMediaRecorder.setOnInfoL istener(this); 
mMediaRecorder.setPreviewDisplay(mHolder.getSurface()); 


mMediaRecorder.setVideoSource( VideoSource.CAMERA ); // 视频 源 
mMediaRecorder.setAudioSource(AudioSource.MIC); // 音频 源 
mMediaRecorder.setOutputFormat(OutputFormat. MPEG 4); // 视频 输出 格式 
mMediaRecordersetAudioEncoder(AudioEncoderAMR_NB); // 音频 格式 


/ 如 果 录 像 报错 : MediaRecorder start failed: -19 
/ 可 注释 setVideoSize 和 setVideoFrameRate， 因 为 尺寸 设置 必须 为 摄像 头 所 支持 ， 否 则 报错 


mMediaRecorder.setVideoEncodingBitRate(1 * 1024 * 512); 11 设置 帧 频率 
mMediaRecorder.setOrientationHint(90); 1/ 输出 旋转 90 度 ， 保 持 竖 屏 录制 
mMediaRecordersetVideoEncoder(VideoEncoderMPEG 4 SP)  // 视频 录制 格式 
mMediaRecordersetMaxDuration(mRecordMaxTime * 1000); // 设置 录制 时 长 


// setMaxFileSize 与 setMaxDuration 设置 一 个 即 可 
mMediaRecorder.setOutputFile(mRecordFilePath); 
try ( 
mMediaRecorder.prepare(); 
mMediaRecorder.start(); 
} catch (Exception e) í 
e.printStackTrace(); 


j 


private void stopRecord() í 
pb record.setProgress(0); 
if (mTimer != null) í 
mTimer.cancel(); 
; 
if (mMediaRecorder !— null) í 
mMediaRecorder.setOnErrorListener(null); 
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mMediaRecorder.setPreviewDisplay(null); 


ty 1 
mMediaRecorder.stop(); 
} catch (Exception e) í 
e.printStackTrace(); 
H 
; 
} 
private void releaseRecord() { 
if (mMediaRecorder != null) { 
mMediaRecorder.setOnErrorListener(null); 
mMediaRecorder.release(); 
mMediaRecorder = null; 
i 
} 


2. 媒体 播放 器 MediaPlayer (放映 部 分 ) 
下 面 是 MediaPlayer 播放 视频 的 专用 方法 (如 果 只 是 播音 ， 就 不 需要 这 些 方法 ) 。 


e setDisplay: 设置 播放 界面 ， 参 数 为 SurfaceHolder 类 型 。 

o setSurface: 设置 播放 表层 ， 参 数 可 通过 SurfaceHolder 对 象 的 getSurface 方法 获得 。 
setDisplay 与 setSurface 两 个 方法 只 需 调 用 一 个 。 

e setScreenOnWhilePlaying: 设置 是 否 使 用 SurfaceHolder 显示 ， 也 就 是 是 否 保持 屏幕 高 亮 ， 
从 而 持续 播放 视频 。 为 true 时 只 能 调用 setDisplay， 不 能 调用 setSurface。 

e setVideoScalingMode: 设置 视频 的 缩放 模式 ， 默 认为 MediaPlayer.VIDEO_SCALING_ 
MODE SCALE TO_FIT， 表 示 固 定 宽 高 。 

e setOnVideoSizeChangedListener: 设置 视频 缩放 监听 器 。 需 要 实现 接口 MediaPlayer. 
OnVideoSizeChangedListener 的 onVideoSizeChanged 方法 。 


放映 与 播音 相 比 ， 在 界面 上 增加 了 SurfaceView， 所 以 布局 文件 要 增加 声明 SurfaceView， 
代码 也 增加 了 对 SurfaceView 的 处 理 。 下 面 是 修改 play 方法 的 代码 片段 ,其 他 部 分 代码 与 音频 
播放 类 似 。 
private void play() í 
try { 
mMediaPlayer.reset(); 
mMediaPlayer.setAudioStreamType(AudioManager. STREAM_MUSIC); 
Log.d(TAG, "video path = " + mVideoPath); 
/| 录制 完毕 要 等 一 秒 钟 再 setDataSource， 因 为 有 可 能 此 时 视频 文件 尚未 完全 写 入 
// 否则 会 报 异常 java.io.IOException: setDataSourceFD failed 
mMediaPlayer.setDataSource(mVideoPath); 
// 把 视频 界面 输出 到 SurfaceView 
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mMediaPlayer.setDisplay(sv play.getHolder()); 
mMediaPlayer.prepare(); 
mMediaPlayer.start(); 
pb play.setMax(mMediaPlayer.getDuration()); 
mTimer = new Timer(); 
mTimer.schedule(new TimerTask() í 
(ajOverride 
public void run() í 
pb play.setProgress(mMediaPlayer.getCurrentPosition()); 
; 
1. 0, 1000); 
} catch (Exception e) í 
e.printStackTrace(); 
J 
j 


视频 录制 与 播放 的 效果 如 图 9-16 和 图 9-17 所 示 。 其 中 ， 图 9-16 所 示 为 录像 时 的 界面 ， 
图 9-17 所 示 为 放映 时 的 界面 。 





开始 录制 











二 始 播 i i 暂停 播放 








图 9-16 录制 视频 时 的 效果 图 图 9-17 播放 视频 时 的 效果 图 
93 传感器 


本 节 介 绍 常见 传感器 的 用 法 与 相关 应 用 场景 ， 首 先 列举 Android 目前 支持 的 传感器 种 类 ， 
然后 对 常用 传感器 分 别 进行 说 明 , 包括 加 速度 传感器 的 用 法 和 摇 一 摇 的 实现 、 磁 场 传感器 的 用 
法 和 指南 针 的 实现 \ 计 步 传感器 的 用 法 和 计 步 器 的 实现 、 光 线 传感器 的 用 法 和 感光 器 的 实现 等 。 
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9.3.4 传感器 的 种 类 
传感器 Sensor 是 一 系列 感应 器 的 总 称 ， 是 Android 设备 用 来 感知 周围 环境 和 运动 信息 的 
工具 。 因 为 具体 的 感应 信息 依赖 于 相关 硬件 ， 所 以 虽然 Android 定义 了 众多 感应 器 , 但 是 不 是 
每 部 手机 都 能 支持 这 么 多 感应 器 ， 千 元 以 下 的 低 端 手机 往往 只 支持 加 速度 等 少数 感应 器 。 


Android 支持 的 传感器 类 型 见 表 9-7。 


表 9-7 ”传感器 类 型 的 取 值 说 明 

















传感器 一 般 借助 于 硬件 监听 环境 信息 改变 ， 有 时 会 结合 软件 监听 用 户 的 运动 信息 。 目 前 ， 











编号 | Sensor 类 的 传感器 类 型 传感器 名 称 说 明 
1 |TYPE ACCELEROMETER 加 速度 常用 于 摇 一 摇 功 能 
2 | TYPE MAGNETIC FIELD 磁场 
3 | TYPE ORIENTATION 方向 已 弃 用 ， 取 而 代 之 的 是 
getOrientation 方法 
4 | TYPE GYROSCOPE 用 来 感应 手机 的 旋转 和 倾斜 
5 | TYPE LIGHT 用 来 感应 手机 正面 的 光线 强 弱 
6 | TYPE PRESSURE 用 来 感应 气压 
7 |TYPE TEMPERATURE 已 弃 用 ， 取 而 代 之 的 是 类 型 13 
8 | TYPE PROXIMITY 
9 |TYPE GRAVITY 





TYPE LINEAR ACCELERATION 





TYPE ROTATION VECTOR 








TYPE RELATIVE HUMIDITY 


TYPE AMBIENT TEMPERATURE 环境 温度 


TYPE MAGNETIC FIELD UNCALIBRATED | 无 标定 磁场 
TYPE GAME ROTATION VECTOR 无 标定 旋转 矢量 
TYPE GYROSCOPE UNCALIBRATED 未 校准 陀螺 仪 


TYPE SIGNIFICANT MOTION 特殊 动作 


























18 | TYPE STEP DETECTOR 步行 检测 用 户 每 走 一 步 就 触发 一 次 事件 
19 | TYPE STEP COUNTER 步行 计数 记录 激活 后 的 步伐 数 

20 | TYPE GEOMAGNETIC ROTATION VECTOR | 地 磁 旋 转 矢量 

21 | TYPE HEART RATE 心跳 速率 可 穿戴 设备 使 用 ， 如 手 环 

22 | TYPE_TILT_DETECTOR 倾斜 检测 

23 | TYPE WAKE GESTURE 唤醒 手势 

24 | TYPE GLANCE GESTURE 掠 过 手势 

25 | TYPE PICK UP GESTURE 抬 起 手势 





查看 当前 设备 支持 的 传感器 种 类 , 可 通过 调用 SensorManager 对 象 的 getSensorList 方法 获 
得 ， 具 体 代码 如 下 : 
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private void showSensorInfo() { 


| 


mSensroMgr = (SensorManager) getSystemService(Context.SENSOR_ SERVICE); 
List<Sensor> sensorList = mSensroMgr.getSensorList(Sensor. TYPE ALL); 
String show content = "当前 支持 的 传感器 包括 : An"; 
for (Sensor sensor : SensorLisb í 
if (sensor.getType() >= mSensorType.length) í 
continue; 
; 
mapSensor put(sensor.getType(), sensor.getName()); 
; 
for (Map.Entry-Integer, String> item map : mapSensor.entrySet()) í 
int type = item map.getKey(); 
String name = item. map.getValue(); 
String content = String.format("%d %s : %s\n", type, mSensorType[type-1], name); 
show content += content; 
] 


tv sensor.setText(show content); 


图 9-18 所 示 为 某 品牌 手机 上 支持 的 传感器 列表 ， 包 含 目前 Android 系统 定义 的 大 部 分 传 


device 


M6DBO Significant Motion Sensor 
10 线性 加 速度 : LSM6DB0 iNemoEngine Linear Acceleration Sensor 





图 9-18 菜品 牌 手机 上 支持 的 传感器 列表 


9.3.2 ”加 速度 传感器 

加 速度 传感器 是 最 常见 的 感应 器 ， 大 部 分 智能 手机 都 内 置 了 加 速度 传感器 。 加 速度 传 感 
器 运用 最 广泛 的 功能 是 微 信 的 摇 一 摇 , 用 户 通 过 摇晃 手机 寻找 周围 的 人 , 其 他 类 似 的 应 用 还 摇 
山子 、 玩 游戏 等 。 














€D 


€ 


下 面 以 摇 一 摇 的 实现 演示 传感器 开发 的 步骤 。 
声明 一 个 SensorManager 对 象 ， 该 对 象 从 系统 服务 SENSOR. SERVICE 中 获取 实例 。 
重 写 Activity 的 onResume 方法 ， 在 该 方法 中 注册 传感器 监听 事件 ， 并 指定 待 监听 的 传 














感 器 类 型 。 例 如 ， 摇 一 摇 功 能 要 注册 加 速度 传感器 ， 代 码 示例 如 下 : 
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mSensroMgr.registerListener(this, 
mSensroMgr.getDefaultSensor(Sensor. TYPE ACCELEROMETER), 
SensorManagerSENSOR DELAY NORMAL); 


@KED3 Æ5 Activity 的 onPause 方法 ， 在 该 方法 中 注销 传 感 吕 





件 ， 代 码 示例 如 下 : 








mSensroMgr.unregisterListener(this); 

EID 编写 一 个 传感器 事件 监听 器 ， 该 监听 器 继承 自 SensorEventListener, [E] Ej 8 Sz g 
onSensorChanged 和 onAccuracyChanged 两 个 方法 。 其 中 ， 前 一 个 方法 在 感应 信息 变化 时 触发 ， 业 务 
逻辑 都 在 这 里 处 理 ， 后 一 个 方法 在 精度 改变 时 触发 ， 一 般 无 须 处 理 。 

下 面 是 使 用 加 速度 传感器 实现 简单 摇 一 摇 的 完整 代码 : 


public class AccelerationActivity extends AppCompatActivity implements SensorEventListener í 
private TextView tv shake; 





private SensorManager mSensroMgr; 
private Vibrator mVibrator; 


(@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity acceleration); 
tv shake = (TextView) findViewByld(R.id.tv shake); 
mSensroMgr = (SensorManager) getSystemService(Context.SENSOR SERVICE; 
mVibrator = (Vibrator) getSystemService(Context. VIBRATOR SERVICE); 


} 


@Override 

protected void onPause() { 
super.onPause(); 
mSensroMgr.unregisterListener(this); 

j 


@Override 
protected void onResume() { 
super.onResume(); 
mSensroMgr.registerListener(this, 
mSensroMgr.getDefaultSensor(Sensor. TYPE ACCELEROMETER), 
SensorManager.SENSOR DELAY NORMAL); 


j 


@Override 
public void onSensorChanged(SensorEvent event) { 
if (event.sensor.getType() = Sensor. TYPE ACCELEROMETER) í 
// values[0]:x $h, values[1] : y fü, values[2] : z 轴 
float[] values — event.values; 
if ((Math.abs(values[0]) > 15 || Math.abs(values[1]) > 15 || Math.abs(values[2]) > 15)) { 
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tv_shake.setText(Utils.getNowTime()+" 恭喜 您 摇 一 摇 啦 "); 
mVibrator.vibrate(500); /系统 检测 到 摇 一 摇 事 件 后 ， 震 动手 机 提示 用 户 


) 


(@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) í 
// 当 传感器 精度 改变 时 回调 该 方法 ， 一 般 无 须 处 理 
} 
} 


这 个 例子 很 简单 ， 一 旦 监测 到 手机 的 摇动 幅度 NN 
超过 阔 值 ， 就 在 屏幕 上 打印 摇 一 摇 的 结果 说 明文 字 ， 
具体 效果 如 图 9-19 所 示 。 s ad 


93.3 ”指南 针 图 9-19 加 速度 传感器 实现 简单 摇 一 摇 


顾名思义 ， 指 南 针 只 要 找到 朝 南 的 方向 就 好 了 ， 可 是 在 App 中 并 非 使 用 一 个 方向 传感器 
这 么 简单 , 事实 上 单独 的 方向 传感器 已 经 弃 用 ,取而代之 的 是 利用 加 速度 传感器 和 磁场 传感器 ， 
通过 SensorManager 的 getRotationMatrix 方法 与 getOrientation 方法 计算 方向 角度 。 
下 面 是 结合 加 速度 传感器 与 磁场 传感器 实现 指南 针 的 完整 代码 : 
public class DirectionActivity extends AppCompatActivity implements SensorEventListener { 
private TextView tv_direction; 








private CompassView ev_sourth; 
private SensorManager mSensroMgr; 
private float[] mAcce Values; 

private float[] mMagnValues; 


(a Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity direction); 
tv direction = (TextView) find ViewById(R.id.tv direction); 
cv sourth = (CompassView) find ViewById(R.id.cv sourth); 
mSensroMgr = (SensorManager) getSystemService(Contex. SENSOR SERVICE); 
h: 


@Override 

protected void onPause() { 
super.onPause(); 
mSensroMgr.unregisterListener(this); 

} 


@Override 
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protected void onResume() í 
super.onResume(); 
int suitable — 0; 
List<Sensor> sensorList = mSensroMgr.getSensorList(Sensor. TYPE ALL); 
for (Sensor sensor : sensorList) í 
if (sensor.getType() = Sensor. TYPE ACCELEROMETER) ( 
suitable 4— 1; 
} else if (sensor.getType() = Sensor. TYPE MAGNETIC FIELD) { 
suitable += 10; 


$ 
if (suitable/10>0 && suitable%10>0) { 
mSensroMgr.registerListener(this, 
mSensroMgr.getDefaultSensor(Sensor. TYPE ACCELEROMETER), 
SensorManager.SENSOR DELAY NORMAL); 
mSensroMgr.registerListener(this, 
mSensroMgr.getDefaultSensor(Sensor. TYPE MAGNETIC FIELD), 
SensorManager.SENSOR DELAY NORMAL); 
} else { 
cv_sourth.setVisibility(View.GONE); 
tv_direction .setText(" 当 前 设备 不 支持 指南 针 ， 请 检查 是 否 存在 加 速度 和 磁场 传感器 "); 


; 


@Override 
public void onSensorChanged(SensorEvent event) { 
if (event.sensor.getType() = Sensor. TYPE ACCELEROMETER) í 
mAcceValues = event.values; 
} else if (event.sensor.getType() = Sensor. TYPE MAGNETIC FIELD) í 
mMagn Values = event.values; 


j 
if (mAcceValues!-null && mMagnValues!-null) í 
calculateOrientation(); 


j 


@Override 
public void onAccuracyChanged(Sensor sensor, int accuracy) í 


j 


// 计算 方向 

private void calculateOrientation() í 
float[] values = new float[3]; 
float[] R = new float[9]; 
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SensorManager.getRotationMatrix(R, null, mAcceValues, mMagn Values); 
SensorManager.getOrientation(R, values); 
values[0] = (float) Math.toDegrees(values[0]); 
cv. sourth.setDirection((int) values[0]); 
if (values[0] >= -10 && values[0] < 10) í 
tv_direction.setText(" 手 机 上 部 方向 是 正 北 "); 
} else if (values[0] >= 10 && values[0] < 80) í 
tv_direction.setText(" 手 机 上 部 方向 是 东北 "); 
} else if (values[0] >= 80 && values[0] <= 100) í 
tv_direction.setText(" 手 机 上 部 方向 是 正 东 "); 
} else if (values[0] >= 100 && values[0] < 170) í 
tv_direction.setText(" 手 机 上 部 方向 是 东南 "); 
} else if ((values[0] >= 170 && values[0] <= 180) || (values[0]) >= -180 && values[0] < -170) í 
tv_direction.setText(" 手 机 上 部 方向 是 正 南 "); 
} else if (values[0] >= -170 && values[0] < -100) í 
tv_direction.setText(" 手 机 上 部 方向 是 西南 "); 
} else if (values[0] >= -100 && values[0] < -80) í 
tv_direction.setText(" 手 机 上 部 方向 是 正 西 "); 
} else if (values[0] >= -80 && values[0] < -10) í 
tv_direction.setText(" 手 机 上 部 方向 是 西北 "); 
] 


} 

上 述 代 码 计算 得 到 的 只 是 手机 上 部 与 正 北 方向 的 角度 ， 要 想 在 手机 上 模拟 指南 针 的 效果 ， 
得 自己 写 一 个 罗盘 视图 , 然后 在 罗盘 上 绘制 出 正 南方 向 的 指针 。 罗盘 视图 上 的 指南 针 效果 如 图 
9-20 和 图 9-21 所 示 。 其 中 ， 图 9-20 所 示 为 手机 上 部 对 准 正 南方 向 的 界面 ， 此 时 指南 针 恰好 位 
于 朝 上 的 方向 ; 转动 手机 使 上 部 对 准 正 东 方向 ， 此 时 指南 针 转 到 了 屏幕 右边 ， 如 图 9-21 所 示 。 














device device 
手机 上 部 方向 是 正 南 手机 上 部 方向 是 正 东 
图 9-20 手机 上 部 对 准 正 南方 向 时 的 指南 针 图 9-21 手机 上 部 对 准 正 东方 向 时 的 指南 针 
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9.3.4 ” 计 步 器 和 感光 器 


其 他 传感器 各 有 千秋 ， 合 理 使 用 能 够 产生 许多 趣味 应 用 。 下 面 分 别 介绍 几 款 用 途 较 广 的 
例子 ， 包 括 计 步 器 、 感 光 器 等 。 


1. 计 步 器 


计 步 器 的 原理 是 通过 手机 的 前 后 摆动 模拟 步伐 节奏 的 监测 。Android 中 与 计 步 器 有 关 的 传 
感 器 有 两 个 , 一 个 是 步行 检测 CTYPE STEP_DETECTOR), 另 一 个 是 步行 计数 CTYPE STEP_ 
COUNTER) 。 其 中 ， 步 行 检测 的 返回 数值 为 1 时 ， 表 示 当 前 监测 到 一 个 步伐 ， 步行 计数 的 返 
回 数值 是 累加 后 的 数值 ， 表 示 本 次 开机 激活 后 的 总 步伐 数 。 

下 面 是 使 用 计 步 器 的 代码 片段 : 

@Override 
public void onSensorChanged(SensorEvent event) { 
if (event.sensor.getType() = Sensor. TYPE STEP DETECTOR) { 
if (event.values[0] = 1.0f) í 
mStepDetector++; 








} 

} else if (event.sensor.getType() = Sensor.TYPE_STEP_COUNTER) í 
mStepCounter = (int) event.values[0]; 

j 

String desc = String.format(" 设 备 检测 到 您 当前 走 了 %d 步 ， 总 计数 为 %d 7b", 

mStepDetector, mStepCounter); 
tv_step.setText(desc); 
j 


计 步 器 的 效果 如 图 9-22 所 示 ， 可 以 看 到 计 步 器 的 总 计数 是 累加 值 。 


device 





设备 检测 到 您 当前 走 了 22 步 ， 总 计数 为 87 步 


图 9-22 计 步 器 的 效果 界面 


2. 感光 器 


感光 器 也 叫 光 线 传感器 ， 借 助 于 前 置 摄像 头 的 上 曝光， 一 旦 谈 住 前 置 摄像 类， 传感器 监 测 
到 的 光线 强度 立马 就 会 降低 。 在 实际 开发 中 ， 光 线 传感器 往往 用 于 感应 手机 正面 的 光线 强 弱 ， 
从 而 自动 调节 屏幕 亮度 。 
使 用 光线 传感器 的 代码 片段 如 下 : 
@Override 
public void onSensorChanged(SensorEvent event) { 
if (event.sensor.getType() — Sensor. TYPE LIGHT) í 
float light strength = event.values[0]: 
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tv light.setText(Utils.getNowTime() + ”当前 光线 强度 为 " + light strength); 


} 
光线 传感器 的 效果 如 图 9-23 所 示 ， 光 线 强 度 的 数值 每 时 每 刻 都 在 变化 。 





GI ens 


22:58:55 当前 光线 强度 为 19.756496 
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9.4 手机 定位 


本 节 介 绍 手机 定位 的 手段 与 实现 ， 首 先 痔 述 手机 定位 的 工作 原理 ， 接 着 指出 各 类 定位 手 
段 对 应 的 手机 功能 开关 ; 然后 对 定位 的 相关 工具 类 进行 详细 说 明 ， 包 括 定 位 条 件 器 Criteria、 
定位 管理 器 LocationManager、 定 位 监听 器 LocationListener; 最 后 演示 通过 定位 功能 获取 定位 
信息 的 用 法 。 


9.4.1 开启 定位 功能 


定位 功能 使 用 得 相当 广泛 ， 许 多 App 都 需要 使 用 定位 功能 找到 用 户 所 在 的 城市 ， 然 后 切 
换 到 对 应 的 城市 频道 。 根 据 不 同 的 定位 方式 ， 手 机 定位 又 分 为 卫星 定位 和 网 络 定位 两 大 类 。 

卫星 定位 服务 由 几 个 全 球 卫星 导航 系统 提供 ， 主 要 包括 美国 GPS、 俄 罗斯 格 洛 纳 斯 、 中 
国 北 斗 。 卫 星 定位 的 原理 是 根据 多 颗 卫 星 与 导航 芯片 的 通信 结果 得 到 手机 与 卫星 距离 , 然后 计 
算 手 机 当前 所 处 的 经 度 、 纬 度 以 及 海拔 高 度 。 使 用 卫星 定位 需 开 启 手机 上 的 GPS 功能 ， 并 且 
最 好 在 室外 使 用 。 

网 络 定位 有 基站 定位 与 WIFI 定位 两 个 子 类 。 手机 插 上 运营 商 提供 的 SIM 卡 后 , 这 个 SIM 
卡 会 搜索 周围 的 基站 信号 并 接 入 通信 服务 。 手 机 基站 俗称 铁塔 ， 每 个 铁塔 都 有 对 应 的 编号 、 位 
置信 息 、 信 号 覆盖 区 域 。 基 站 定位 的 原理 是 监测 SIM 卡 能 搜索 到 周围 的 哪些 基站 ， 手 机 必然 
处 于 这 些 基站 信号 覆盖 的 重合 区 域 , 再 根据 每 个 基站 的 位 置信 息 得 出 手机 的 大 致 方位 。 使 用 基 
站 定位 需 开 启 手机 上 的 数据 连接 功能 。 








的 路 由 器 有 自身 的 MAC 地 址 与 电信 宽带 的 网 络 了 PP， 通过 查询 WIFI 路 由 器 的 位 置 便 可 得 知 接 
入 该 WIFI 手机 的 大 致 位 置 。 使 用 WIFI 定位 需 开 启 手机 上 的 WLAN 功能 。 

无 论 是 基站 定位 还 是 WIFI 定位 ， 手 机 自身 只 能 获取 基站 与 WIFI 路 由 器 的 信息 ， 无 法 直 
接 得 到 手机 的 位 置信 息 。 要 想 获得 具体 的 方位 ， 必 须 先 把 基站 或 WIFI 路 由 器 的 信息 传 给 位 置 
服务 提供 商 〈 比 如 高 德 地 图 或 百度 地 图 )， 位 置 服务 器 储存 了 每 个 基站 和 WIFI 路 由 器 的 编号 、 
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MAC 地 址 、 实 际 位 置 ， 从 这 个 庞大 的 网 络 数据 库 找到 具体 基站 或 WIFI 的 详细 位 置 ， 青 返回 
给 手机 客户 端 。 因 为 需要 后 端的 网 络 参与 计算 手机 的 位 置信 息 ， 所 以 基站 定位 和 WIFI 定位 统 
称 为 网 络 定位 ， 国 产 手机 网 络 定位 的 计算 功能 由 高 德 地 图 和 百度 地 图 分 别提 供 。 
既然 使 用 这 几 种 定位 都 要 开启 对 应 的 手机 功能 ， 那 么 首先 得 获取 这 些 功 能 的 开关 状态 ， 
然后 根据 需要 开启 或 关闭 对 应 的 功能 。 下 面 是 对 GPS、 数 据 连 接 、WLAN 功能 进行 状态 获取 
和 开关 操作 的 代码 : 
/ 获取 GPS 的 开关 状态 
public static boolean getGpsStatus(Context ctx) { 
LocationManager Im = (LocationManager) ctx.getSystemService(Context.LOCATION_SERVICE); 
boolean gps_enabled = lm.isProviderEnabled(Location Manager.GPS_PROVIDER); 
return gps_enabled; 


























; 


// 打开 或 关闭 GPS 
(@TargetApi(Build.VERSION_CODES.KITKAT) 
public static void setGpsStatus(Context ctx, boolean enabled) í 
Intent gpsIntent = new Intent(); 
gpsIntent.setClassName("com.android.settings", 
"com.android.settings.widget.SettingsAppWidgetProvider"); 
gpsIntent.addCategory("android.intent.category.A LTERNATIVE"); 
gpsIntent.setData(Uri.parse("custom:3")); 
try ( 
PendingIntent.getBroadcast(ctx, 0, gpsIntent, 0).send(); 
} catch (Exception e) í 
e.printStackTrace(); 


} 


/ 获取 定位 的 开关 状态 

public static boolean getLocationStatus(Context ctx) { 
LocationManager Im = (LocationManager) ctx.getSystemService(Context. LOCATION_SERVICE): 
boolean gps_enabled = Im.isProviderEnabled(LocationManager.GPS_PROVIDER); 
boolean network enabled = Im.isProviderEnabled(Location Manager. NETWORK PROVIDER); 
return gps_enabled || network_enabled; 

h 


// 获取 WIFI 的 开关 状态 

public static boolean getWlanStatus(Context ctx) í 
WifiManager wm = (WifiManager) ctx.getSystemService(Context.WIFI_SERVICE); 
return wm.is WifiEnabled(); 
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/ 打开 或 关闭 WIFI 

public static void setWlanStatus(Context ctx, boolean enabled) { 
WifiManager wm = (WifiManager) ctx.getSystemService(Context.WIFI SERVICE); 
wm.setWifiEnabled(enabled); 


/ 获取 数据 连接 的 开关 状态 
public static boolean getMobileDataStatus(Context ctx) í 
ConnectivityManager cm = (ConnectivityManager) ctx.getSystemService(Context. 
CONNECTIVITY_SERVICE); 
boolean isOpen = false; 
ty ( 
Method method = cm.getClass().getMethod("getMobileDataEnabled"); 
isOpen = (Boolean) method.invoke(cm); 
} catch (Exception e) í 
e.printStackTrace(); 
j 


return isOpen; 


/ 打开 或 关闭 数据 连接 
public static void setMobileDataStatus(Context ctx, boolean enabled) í 
ConnectivityManager cm = (ConnectivityManager) ctx.getSystemService(Context. 
CONNECTIVITY_SERVICE); 
try ( 
Method method — cm.getClass().getMethod("setMobileDataEnabled", Boolean.TY PE); 
method.invoke(cm, enabled); 
} catch (Exception e) í 
e.printStackTrace(); 


} 


以 上 定位 的 相关 功能 还 需 在 AndroidManifest.xml. 中 补充 对 应 的 权限 信息 ， 上 有 具体 的 权限 说 
明 如 下 : 


<!-- 定位 -> 

<uses-permission android:name="android.permission.ACCESS_FINE LOCATION" /> 
<uses-permission android:name="android.permission.ACCESS_COARSE LOCATION" /> 
<!-- 查看 网 络 状态 -> 

<uses-permission android:name="android.permission.ACCESS_NETWORK STATE" > 
<uses-permission android:name="android.permission.ACCESS_WIFI STATE" > 

<!-- 查看 手机 状态 -> 

<uses-permission android:name-"android.permission.READ PHONE STATE" /> 
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9.44.0 ”获取 定位 信息 


开启 定位 相关 功能 只 是 将 定位 的 前 提 条 件 准备 好 ， 若 想 获 得 手机 当前 所 处 的 位 置信 息 ， 
还 要 依靠 一 系列 定位 工具 。 与 定位 信息 获取 有 关 的 工具 有 定位 条 件 器 Criteria、 定 位 管理 器 
LocationManager、 定 位 监听 器 LocationListener。 下 面 对 这 3 个 工具 分 别 进行 介绍 。 

1. 定位 条 件 器 Criteria 

定位 条 件 器 用 于 设置 定位 的 前 提 条 件 ， 比 如 精度 、 速 度 、 海 拔 、 方 位 等 信息 ， 有 以 下 4 
个 常用 参数 。 

e setAccuracy: 设置 定位 精确 度 。 有 两 个 取 值 ，Criteria.ACCURACY_FINE 表示 精度 高 ， 

Criteria.ACCURACY_COARSE 表示 精度 低 。 
e setSpeedAccuracy: 设置 速度 精确 度 。 速 度 精确 度 的 取 值 说 明 见 表 9-8。 


表 9-8 ”速度 精确 度 的 取 值 说 明 














Criteria 类 的 速度 精确 度 说 明 
ACCURACY HIGH 精度 高 ， 误 差 小 于 100% 
ACCURACY MEDIUM 精度 中 等 ， 误 差 在 100 米 到 500 米 之 间 
ACCURACY LOW 精度 低 ， 误 差 大 于 500 米 
e setAltitudeRequired: 设置 是 否 需要 海拔 信息 。 取 值 tue 表示 需要 ，false 表示 不 需要 。 
e setBearingRequired: 设置 是 否 需要 方位 信息 。 取 值 true 表示 需要 ，false 表示 不 需要 。 
e setCostAllowed: 设置 是 否 允许 运营 商 收费 。 取 值 trie 表示 允许 ，false 表示 不 允许 。 
e setPowerRequirement: 设置 对 电源 的 需求 。 有 3 ARIE, Criteria. POWER_LOW 表示 耗 


电 低 ，Criteria.POWER_MEDIUM 表示 耗 电 中 等 ，Criteria. POWER_HIGH 表示 耗 电 高 。 
2. 定位 管理 器 LocationManager 
定位 管理 器 用 于 获取 定位 信息 的 提供 者 、 设 置 监听 器 ， 并 获取 最 近 一 次 的 位 置信 息 。 定 
位 管理 器 的 对 象 从 系统 服务 LOCATION SERVICE 获取 ， 常 用 方法 有 以 下 7 个。 


e getBestProvider: 获取 最 佳 的 定位 提供 者 。 第 一 个 参数 为 定位 条 件 器 Criteria 的 实例 ， 第 
二 个 参数 取 值 true 表示 只 要 可 用 的 。 定 位 提供 者 的 取 值 说 明 见 表 9-9。 


表 9-9 定位 提供 者 的 取 值 说 明 

















定位 提供 者 的 名 称 说 明 定位 功能 的 开启 状态 

gps 卫星 定位 开启 GPS 功能 

network 网 络 定位 开启 数据 连接 或 WLAN 功能 
passive 无 法 定位 未 开启 定位 相关 功能 


e isProviderEnabled: 判断 指定 的 定位 提供 者 是 否 可 用 。 
e getLastKnownLocation: 获取 最 近 一 次 的 定位 地 点 。 
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3. 


requestLocationUpdates: 设置 定位 监听 器 。 其 中 ， 第 一 个 参数 为 定位 提供 者 ， 第 二 个 参 
数 为 位 置 更 新 的 最 小 间隔 时 间 ， 第 三 个 参数 为 位 置 更 新 的 最 小 距离 ， 第 四 个 参数 为 定位 
监听 器 实例 。 

removeUpdates: 移 除 定位 监听 器 。 

addGpsStatusListener: 添加 定位 状态 的 监听 器 。 该 监听 器 需 实 现 GpsStatus.Listener 接口 
的 onGpsStatusChanged 方法 。 

removeGpsStatusListener: 移 除 定位 状态 的 监听 器 。 


定位 监听 器 LocationListener 


定位 监听 器 用 于 监听 定位 信息 的 变化 事件 ， 如 定位 提供 者 的 开关 、 位 置信 息 发 生变 化 等 。 
该 监听 器 可 使 用 以 下 4 种 方法 。 


onLocationChanged: 在 位 置地 点 发 生变 化 时 调用 。 在 此 可 获取 最 新 的 位 置信 息 。 
onProviderDisabled: 在 定位 提供 者 被 用 户 关 闭 时 调用 。 

onProviderEnabled: 在 定位 提供 者 被 用 户 开启 时 调用 。 

onStatusChanged: 在 定位 提供 者 的 状态 变化 时 调用 。 定 位 提供 者 的 状态 取 值 说 明 见 表 
9-10. 


表 9-10 ”定位 提供 者 的 状态 取 值 说 阴 





LocationProvider 类 的 状态 类 型 说 明 

OUT OF SERVICE 在 服务 范围 外 
TEMPORARILY_UNAVAILABLE 暂时 不 可 用 
AVAILABLE 可 用 状态 





获取 定位 信息 的 示例 代码 如 下 : 


public class LocationActivity extends AppCompatActivity í 


private final static String TAG = "LocationActivity"; 
private TextView tv location; 

private String mLocation-""; 

private LocationManager mLocationMgr; 

private Criteria mCriteria — new Criteria(); 

private Handler mHandler = new Handler); 

private boolean bLocationEnable — false; 


(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity location); 
initWidget(); 
initLocation(); 
mHandler.postDelayed(mRefresh, 100); 
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private void initWidget() í 
tv location = (TextView) findViewById(R.id.tv location); 
mLocationMgr = (LocationManager) getSystemService(Context. LOCATION SERVICE); 
mCriteria.setAccuracy(Criteria.ACCURACY FINE); // 设置 定位 精确 度 
mCriteria.setAltitudeRequired(true); // 设置 是 否 需 要 海拔 信息 Altitude 
mCriteria.setBearingRequired(true); / 设置 是 否 需 要 方位 信息 Bearing 
mCriteria.setCostAllowed(true); // 设置 是 否 允 许 运营 商 收费 
mCriteria.setPowerRequirement(Criteria.POWER LOW); // 设置 对 电源 的 需求 


private void initLocation() í 

String bestProvider = mLocationMgr.getBestProvider(mCriteria, true); 

if (bestProvider — null) í 
bestProvider = LocationManager. NETWORK PROVIDER; 

) 

if (mLocationMgr.isProviderEnabled(bestProvider)) í 
tv_location.setText(" 正 在 获取 "+bestProvider+" 定 位 对 象 "); 
mLocation = String.format(" 定 位 类 型 =%s", bestProvider); 
beginLocation(bestProvider); 
bLocationEnable = true; 

) else í 
tv_location.setText("\n"+bestProvider+" 定 位 不 可 用 "); 
bLocationEnable = false; 


private void setLocationText(Location location) { 
if (location != null) í 
String desc = String.format("%sm 定位 对 象 信息 如 下 : "+ 
"nt 其 中 时 间 : %s"+ "mt 其 中 经 度 : %f， 纬 度 : %f" + 
"nt 其 中 高 度 : %d 米 ， 精 度 : %d OK", 
mLocation, Utils.getNowDateTimeFormat(), 
location.getLongitude(), location.getLatitude(), 
Math.round(location.getAltitude()), Math.round(location.getA ccuracy())); 
Log.d(TAG, desc); 
tv location.setText(desc); 
yelse í 
tv location.setText(mLocation--"n 暂 未 获取 定位 对 象 "); 
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private void beginLocation(String method) í 
mLocationMgrrequestLocationUpdates(method, 300, 0, mLocationListener); 
Location location = mLocationMgr.getLastKnownLocation(method); 
setLocationText(location); 


// 位 置 监听 器 
private LocationListener mLocationListener = new LocationListener() í 
(@Override 
public void onLocationChanged(Location location) í 
setLocationText(location); 


@Override 
public void onProviderDisabled(String arg0) { 
ji 


@Override 
public void onProviderEnabled(String arg0) { 
} 


@Override 
public void onStatusChanged(String arg0, int arg1, Bundle arg2) ( 
l 

h 


private Runnable mRefresh = new Runnable() í 


(@Override 
public void run() í 
if (bLocationEnable == false) í 
initLocation(); 
mHandler.postDelayed(this, 1000); 
j 
j 
h 
@Override 


protected void onDestroy() { 
if (mLocationMgr != null) í 
mLocationMgr.removeUpdates(mLocationListener); 


; 
super.onDestroy(); 
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获取 定位 信息 的 效果 如 图 9-24 所 示 ， 当 前 定位 类 型 是 卫星 定位 , 定位 结果 是 东经 119 RE. 
北纬 26 度 ， 海 拔高 度 77 米 ， 定 位 精度 6 米 。 





定位 对 象 信息 如 下 : 

其 中 时 间 : 2016-11-05 23:10:58 

其 中 经 度 : 119.332101， 纬 度 : 26.146713 
其 中 高 度 : 77 米 ， 精 度 : 6 米 





图 924 菜 设备 获取 的 定位 信息 
9.5 KRMH: 仿 微 信 的 发 现 功 能 


本 章 涉及 的 知识 点 比较 庞杂 ， 前 面 介绍 的 大 多 是 基础 功能 应 用 ， 很 少 有 实际 业务 的 使 用 
说 明 。 本 节 的 实战 项 目 谈 谈 手 机 的 设备 功能 在 商用 App 中 的 具体 应 用 ， 让 读者 站 在 用 户 角 度 
对 设备 操作 有 一 个 感性 认识 ， 如果 想 做 一 个 受 欢迎 的 App, 不 仅 需要 钻研 技术 ， 更 要 贴近 用 户 
生活 ， 研 发 易 用 、 好 用 、 值 得 用 的 App. 

9.5.1 设计 思 


微 信 的 用 户 量 巨大 ， 不 少 小 功能 都 很 人 性 化 ， 比 如 发 现 频道 ， 如 图 9-25 所 示 。 

发 现 频道 提供 的 小 功能 包括 扫 一 扫 、 摇 一 摇 、 附 近 的 人 、 漂 流 瓶 等 ， 如 附近 的 人 、 漂 流 
瓶 等 需要 多 人 参与 的 功能 不 纳入 本 次 实战 项 目 , 扫 一 扫 与 摇 一 摇 相 对 纯粹 ,加 入 实战 项 目 当中 。 

另外 ， 支 付 宝 原来 有 一 个 呆 一 听 功 能 也 很 有 名 。2016 年 前 的 除夕 夜 ， 全 民 开 局 味 一 听 疯 
抢 五 福 卡 ， 这 个 场景 片段 登 上 了 当年 的 春晚 菊 屏 。 不 过 ， 支 付 宝 日 常 的 啉 一 只 并 非 寻 找 福 袋 ， 
而 是 搜索 用 户 附 近 的 商家 信息 。 

现在 ， 我 们 综合 微 信和 与 支付 宝 的 几 个 小 功能 组 成 本 章 的 实战 项 目 一 一 “ 仿 微 信 的 发 现 功 
能 ”。 该 功能 内 含 3 个 模块 ， 分 别 是 扫 一 扫 、 摇 一 摇 和 啉 一 啉 ， 入 口 效 果 如 图 9-26 所 示 。 


ET 


扫 一 扫 (扫描 二 维 码 ) 
EE ( 博 饼 中 大 奖 ) 
W — PERR) 








925 ” 微 信 的 发 现 频道 截图 图 9-26 仿 微 信 的 发 现 功能 页 面 截图 
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下 面 分 别 说 明 这 3 个 模块 将 要 实现 的 功能 。 
1. 扫 一 扫 (扫描 二 维 码 ) 


该 模块 与 微 信 的 “ 扫 一 扫 ” 基 本 类 似 ， 通 过 扫描 
二 维 码 图 片 识别 二 维 码 携带 的 字符 串 信 息 。 Android 中 
的 二 维 码 扫描 可 用 谷歌 的 zxing 工具 包 结 合 zxing 的 开 
源 框架 完成 扫 码 与 识别 操作 。 扫 一 扫 的 效果 如 图 9-27 
所 示 ， 此 时 手机 在 进行 图 像 识 别 。 

2. 摇 一 摇 ( 博 饼 抽 大 奖 ) 

微 信 的 “ 摇 一 摇 ” 可 以 摇 人 、 摇 歌曲 、 摇 电视 ， 
我 们 另辟蹊径 , 做 一 个 摇 贷 子 的 游戏 一 一 中 秋 博 饼 ”。 图 927 扫 扫 (扫描 二 维 码 ) 的 初始 界面 
300 多 年 前 ， 民 族 英 雄 郑成功 率 军 驻扎 在 厦门 进行 抗 清 活动 ， 每 逢 中 秋 佳 节 ， 为 宽慰 士兵 的 思 
乡 之 情 ， 发 明了 名 为 “ 博 饼 ” 的 摇 仍 子 游戏 ， 依 据 不 同 的 幸运 点 数 判定 不 同 的 中 奖级 别 。 经 过 
几 百 年 的 流传 , 中 秋 节 博 饼 的 习俗 已 经 广泛 流传 于 韶 台 两 地 与 东南 亚 。 本 实战 项 目 通过 摇 手 机 
触发 摇 山 子 的 动作 ， 进 而 计算 每 次 的 中 奖 结果 。 博 饼 抽 大 奖 的 效果 如 图 9-28 所 示 ， 这 是 博 饼 
游戏 的 初始 界面 。 

















图 9-28 摇 一 摇 〈 博 饼 抽 大 奖 ) 的 初始 界面 图 9-29 啉 一 啉 (卫星 浑 天 仪 ) 的 初始 界面 
3. 啉 一 啉 (卫星 浑 天 仪 ) 


浑 天 仪 为 东汉 科学 家 张衡 发 明 ， 用 于 观测 天 象 ， 日 月 星辰 皆 可 在 浑 天 仪 上 找到 对 应 的 位 
置 。 随 着 现代 科技 的 发 展 ， 我 们 已 经 不 满足 于 自古 以 来 就 有 的 日 月 星辰 ， 而 是 把 现在 的 科技 成 
果 展 示 出 来 。 前 面 提 到 ， 手 机 定位 的 一 大 手段 是 卫星 定位 ， 既 然 卫 星 能 够 发 现 手机 的 位 置 ， 反 
过 来 手机 也 能 发 现 卫星 的 方位 ,把 手机 (导航 芯片 ) 监测 到 的 卫星 逐个 标记 在 罗盘 上 浊 不 构成 
了 一 个 卫星 浑 天 仪 ? 卫星 浑 天 仪 的 效果 如 图 9-29 所 示 ， 一 开始 只 有 一 个 罗盘 ， 具 体 的 卫星 信 
息 还 有 待 在 代码 中 获取 ， 并 显示 到 罗盘 上 。 

分 析 实战 项 目 3 个 模块 的 功能 大 致 包含 本 章 哪些 知识 点 ? 读者 肯定 能 找到 以 下 4 点。 

CD 相机 类 Camera: 扫描 二 维 码 需 要 摄像 头 支持 ， 必 然 用 到 Camera, 

(2) 加 速度 传感器 SensorManager: 前 面 介绍 加 速度 传感器 时 已 经 提 到 它 通常 用 于 播 一 摇 。 
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G) 卫星 定位 LocationManager: 无 论 是 根据 卫星 找 手机 的 位 置 ， 还 是 通过 手机 监测 卫星 
的 位 置 ， 都 会 用 到 定位 功能 。 

CA) 媒体 播放 MediaPlayer: 好 几 个 场景 需要 播放 声音 ， 比 如 二 维 码 识别 完毕 的 “ 哗 ” 声 ， 
HERBI, MRI MRNK” JE, EAEE MediaPlayer 播音 。 


涉及 的 知识 点 不 算 多 ， 但 也 基本 涵盖 了 每 节 的 代表 技术 。 
952 ”小 知识 : 全 球 卫 星 导 航 系统 


卫星 导航 是 高 科技 的 航天 技术 ， 目 前 联合 国 认 可 的 全 球 卫星 导航 系统 有 4 个 ， 分 别 是 美国 
的 GPS、 俄罗斯 的 格 洛 纳 斯 、 中 国 的 北斗 和 欧洲 的 伽利略 ， 其 中 真正 投入 商用 的 只 有 前 3 个 。 


(1) 美国 的 GPS: GPS 是 Global Positioning System (全 球 定位 系统 ) 的 简称 ， 于 1964 
年 投入 使 用 。 到 1993 年 ， 包 含 24 颗 卫 星 的 GPS 系统 完成 组 网 。 

(20 俄罗斯 的 格 洛 纳 斯 : 格 洛 纳 斯 CGLONASSO 是 俄语 对 全 球 卫星 导航 系统 Global 
Navigation Satellite System 的 简称 ， 该 系统 于 2007 年 开始 运营 , 并 在 2011 年 完成 24 颗 卫星 的 
组 网 。 

G) 中 国 的 北斗 : 北斗 (BeiDou Navigation Satellite System, BDS) 是 中 国 自 行 研 制 的 全 
球 卫星 导航 系统 ， 是 继 美国 GPS、 俄 罗斯 格 洛 纳 斯 之 后 第 3 个 成 熟 的 卫星 导航 系统 。 北 斗 在 
2007 年 开始 提供 定位 服务 ，2012 年 完成 16 颖 卫星 的 亚太 地 区 组 网 ， 计 划 于 2020 年 完成 35 
颗 卫星 的 全 球 组 网 。 

(4) 欧洲 的 伽利略 : 伽利略 卫星 导航 系统 (Galileo Satellite Navigation System) 是 由 欧盟 
研制 和 建立 的 全 球 卫星 导航 定位 系统 ， 于 2013 年 完成 4 颗 卫星 的 初步 组 网 ， 但 建设 进度 严重 
滞后 ， 能 够 提供 定位 服务 仍 是 遥遥 无 期 。 
目前 ， 智 能 手机 一 般 都 内 置 GPS 的 导航 芯片 ， 只 有 部 分 中 、 高 端 手机 同时 内 置 格 洛 纳 斯 
与 北斗 的 导航 芯片 。 

要 想 获 取 天 上 的 卫星 信息 ， 得 调用 定位 管理 器 LocationManager 对 象 的 addGpsStatusListener 
方法 添加 定位 状态 监听 器 ， 该 监听 器 需 实现 GpsStatus.Listener 接口 的 onGpsStatusChanged 77 
法 ， 该 方法 提供 了 定位 状态 变化 的 事件 信息 ， 事 件 类 型 的 取 值 说 明 见 表 9-11。 

表 9-11 GPS 事件 类 型 的 取 值 说 明 





























GpsStatus 类 的 事件 类 型 说 明 

GPS EVENT STARTED GPS 功能 开启 

GPS EVENT STOPPED GPS 功能 停止 

GPS EVENT FIRST FIX 首次 定位 

GPS EVENT SATELLITE STATUS 周期 地 报告 卫星 状态 


其 中 ， 最 后 一 个 卫星 状态 报告 事件 可 以 获得 监测 到 的 卫星 信息 ， 一 旦 捕获 该 事件 ， 即 可 
调用 LocationManager 对 象 的 getGpsStatus 方法 获得 当前 的 定位 状态 信息 GpsStatus， 再 调用 
GpsStatus 对 象 的 getSatellites 方法 获得 本 次 监测 到 的 卫星 列表 ， 卫 星 列表 是 一 个 GpsSatellite 
队列 ， 详 细 的 卫星 信息 可 通过 GpsSatellite 对 象 的 以 下 方法 获得 。 
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getPm: 卫星 的 伪 随 机 码 ， 可 以 认为 是 卫星 的 编号 。 
getAzimuth: 获取 卫星 的 方位 角 。 

getElevation: 获取 卫星 的 仰角 。 

getSn: 卫星 的 信 噪 比 ， 即 信号 强 弱 。 
hasAlmanac: 卫星 是 否 有 年 历 表 。 

hasEphemeris: 卫星 是 否 有 星 历 表 。 

usedInFix: 卫星 是 否 被 用 于 近期 的 GPS 修正 计算 。 


在 这 些 信息 中 ， 对 确定 卫星 位 置 有 用 的 主要 有 3 个 ， 分 别 是 卫星 编号 〈 用 于 确定 卫星 的 
国籍 ) 、 卫 星 的 方位 角 〈 用 于 确定 卫星 的 方向 ) 和 卫星 的 仰角 《用 于 确定 卫星 的 远近 距离 ) 。 
下 面 是 获取 导航 卫星 信息 的 监听 器 代码 片段 : 
private GpsStatus.Listener mStatusListener = new GpsStatus.Listener() í 
@Override 
public void onGpsStatusChanged(int event) { 
GpsStatus gpsStatus = mLocationMgr.getGpsStatus(null); 
switch (event) { 
case GpsStatus.GPS EVENT FIRST FIX: 
break; 
case GpsStatus.GPS EVENT SATELLITE STATUS: // 周期 的 报告 卫星 状态 
/ 得 到 所 有 卫星 信息 ， 包 括 高 度 角 、 方 位 角 、 信 品 比 和 伪 随 机 号 (卫星 编号 ) 
Tterable<GpsSatellite> satellites = gpsStatus.getSatellites(); 
for (GpsSatellite satellite : satellites) { 
Satellite item = new Satellite(); 
item.seq = satellite.getPm(); 
item.signal = Math.round(satellite.getSnr()); 
item.elevation = Math.round(satellite.getElevation()); 
item.azimuth = Math.round(satellite.getAzimuth()); 
item.time = Utils.getNowDateTime(); 
if (item.seq <= 64 || (item.seq >= 120 && item.seq <= 138)) { 
item.nation = "美国 "; 
item.name = "GPS"; 
} else if (item.seq >= 201 && item.seq <= 237) ( 
item. nation = "HE"; 
item.name = "北斗 "; 
} else if (item.seq >= 65 && item.seq <= 89) í 
item.nation = "俄罗斯 "; 
item.name = " 格 洛 纳 斯 "; 
} else í 
item. nation = "其 他 "; 
item .name = "未 知 "; 


} 
mapSatellite.put(item.seq, item); 
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; 
cv satellite.setSatelliteMap(mapSatellite); 
case GpsStatus.GPS EVENT STARTED: 
break; 
case GpsStatus.GPS EVENT STOPPED: 
break; 
default: 
break; 
j 


h 
953 ”代码 示例 
从 本 章 开始 ， 代 码 示例 一 节 将 更 侧重 于 在 真 机 上 进行 相关 测试 ， 对 于 编码 上 的 说 明 仅 限 


CD 扫 一 扫 用 到 了 zxing 工具 包 ， 要 在 libs 目录 导入 对 应 的 JAR 包 ， 即 zxing3.2.1.jar。 
同时 还 要 在 Java 源码 目录 导入 com.app.zxing 的 开源 框架 。 
(2) 使 用 摄像 头 与 定位 功能 ， 不 要 忘 了 往 AndroidManifest.xml 添加 对 应 的 权限 配置 。 
<uses-permission android:name="android.permission.CAMERA" /> 


<uses-permission android:name="android.permission.ACCESS_FINE LOCATION"/> 
<uses-permission android:name="android.permission.ACCESS_COARSE LOCATION" /> 


(3) fE res/raw 目录 下 保存 播放 “ 哗 ” 声 的 音频 文件 ， 在 res/values 目录 下 保存 zxing RE 
架 依赖 的 ids.xml。 
(A) 需要 自 定 义 一 个 博 饼 视 图 BettingView， 用 于 展示 摇 货 子 的 动态 效果 。 还 需 自 定义 一 
个 罗盘 视图 CompassView， 用 于 展示 天 空 坐标 和 天 上 的 卫星 分 布 图 。 
(5) App 需要 完全 的 GPS 权限 ， 不 需要 提示 那 种 ， 否 则 打开 用 到 GPS 功能 的 页 面 时 会 
实战 项 目 在 模拟 器 上 测试 通过 后 ， 按 照 第 8 章 的 说 明 将 App 安装 到 手机 上 ， 使 用 真 机 进 
行 实际 的 功能 测试 。 
首先 测试 扫 一 扫 功 能 。 图 9-30 所 示 为 一 张 清华 大 学 微 信 公 众 号 的 二 维 码 图 片 。 扫 描 结果 
如 图 9-31 所 示 ， 识 别 的 字符 串 是 一 个 指向 微 信 服务 器 的 HTTP 连接 字符 串 。 





扫 码 结果 为 : http://weixin.qq.com/r/ 


UOMMFPvEqabWrb939xZB 








图 9-30 ”清华 大 学 微 信 公 众 号 的 二 维 码 图 片 图 9-31 扫描 二 维 码 的 识别 结果 
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扫 一 扫 其 实 不 只 可 以 扫描 二 维 码 ， 还 可 扫描 条 形 码 。 图 9-32 所 示 为 一 张 常见 的 商品 条 形 
码 图 片 。 扫 描 结果 如 图 9-33 所 示 ， 识 别 的 是 一 串 数字 编号 。 


| 3 


39382 00039 
图 9-32 某 商品 的 条 形 码 图 片 图 9-33 ”扫描 条 形 码 的 识别 结果 
接着 测试 摇 一 摇 功 能 ， 拿 起 手机 使 劲 晃 荡 几 下 ， 看 看 屏幕 界面 是 不 是 动 了 起 来 ? 图 9-34 
与 图 9-35 是 两 张 不 同 的 中 奖 效果 图 。 其 中 ， 图 9-34 表示 摇 中 了 秀才 奖 (一 个 红 四 ) ， 图 9-35 
表示 摇 中 了 状元 奖 (4 个 红 四 ) 。 






















































































扫 码 结果 为 : 639382000393 














恭喜 ， 您 的 博 饼 结果 为 : 一 秀 恭喜 ， 您 的 博 饼 结果 为 : 状元 (四 点 红 ) 


图 9-34 摇 一 摇 中 了 一 秀 图 9-35 摇 一 摇 中 了 状元 


因为 骨 子 上 的 四 点 与 一 点 为 红色 ， 所 以 博 饼 的 中 奖 点 数 围绕 红 四 与 红 一 制定 。 下 面 来 看 
具体 的 中 奖 规则 。 


状元 插 金 花 : 4 个 红 四 加 两 个 红 一 

六 杯 红 : 有 6 个 红 四 

遍地 锦 : 有 6 个 红 一 

五 红 : 有 5 个 红 四 

四 点 红 : 有 4 个 红 四 

五 子 登 科 : 有 5 个 相同 的 点 数 〈5 个 红 四 除外 ) 

上 面 几 个 都 是 状元 ， 以 状元 插 金 花 为 最 大 。 

对 堂 〈 榜 眼 和 探花 ) : 6 个 仍 子 分 别 是 一 、 二 、 三 、 四 、 五 、 六 
四 进 《〈 进 士 ) : 有 4 个 相同 的 点 数 〈4 个 红 四 除外 》 
三 红 : 有 3 个 红 四 

Z% A) : 有 两 个 红 四 

一 秀 (840 : 只 有 一 个 红 四 
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Bd r 88, KWRA ACHRE, RTEA PIERA TIT f ae rZ Du 
法 ， 要 不 要 把 你 们 的 玩法 写 到 摇 一 摇 里 面 去 呢 ? 

最 后 测试 味 一 听 功 能 ， 这 个 必须 找 个 好 一 点 的 手机 ， 因 为 配置 好 的 手机 才 有 格 洛 纳 斯 与 
北斗 的 导航 芯片 。 图 9-36 所 示 的 手机 只 支持 GPS 芯片 , 效果 图 上 满 屏 都 是 美国 的 卫星 。 图 9-37 
所 示 的 手机 同时 内 置 GPS、 格 洛 纳 斯 与 北斗 的 芯片 ， 效 果 图 上 的 卫星 三 国都 有 。 


device 





位 类 型 ; gps， 定 位 时 间 ; 22:52:59 当前 定位 类 型 : gps， 定 位 时 间 ; 22:03:16 


经 | 119.330982, "IEE: 26.143372 经 度 : 119.331964, tE: 26.146343 
Eu 480%, fifi: TO 高 度 : 103 米 ， 精 度 : 8 米 





9-36 只 支持 GPS 的 卫星 分 布 图 图 9-37 支持 3 种 导航 系统 的 卫星 分 布 图 
如 果 手 机 只 支持 GPS， 定 位 响应 就 很 慢 ， 定 位 精度 一 般 在 10 米 左 右 ， 而 且 定位 高 度 很 不 
WE, 误差 相当 大 。 一旦 有 北斗 与 格 洛 纳 斯 参与 定位 ， 即 使 在 室内 也 能 很 快 响 应 ， 精 度 一 般 能 提 
升 至 5 米 ， 并 且 高 度数 值 准确 了 许多 ， 特 别 适 合 亚太 地 区 的 定位 需求 。 
再 来 看 图 9-37 所 示 的 卫星 分 布 。 在 笔者 头顶 这 片 天 空 半 小 时 内 一 共 找到 11 SL GPS 卫星 、 
6 颗 格 洛 纳 斯 卫星 、12 颗 北斗 卫星 ， 原 来 中 国 的 北斗 已 经 赶 上 并 超过 美国 的 GPS 了 。 身 为 中 
国人 的 你 , 有 没有 感到 无 比 感动 与 自豪 ? 快 快 拿 出 手机 试 试 味 一 听 功 能 , 看 看 你 头 上 的 天 空 能 
找到 几 颗 卫星 。 
下 面 是 罗盘 视图 CompassView 的 代码 (可 被 指南 针 与 浑 天 仪 两 个 功能 复 用 〉: 
public class CompassView extends View { 
private final static String TAG = "CompassView"; 
private Context mContext; 
private int mWidth; 
private Paint mPaintLine; 
private Paint mPaintText; 
private Paint mPaintAngle; 
private Bitmap mCompassBg; 
private Rect mRectSrc; 
private Rect mRectDest; 
private RectF mRectAngle; 
private RectF mRectSourth; 
private Bitmap mSatelliteChina; 
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private Bitmap mSatellite America; 

private Bitmap mSatelliteRussia; 

private Map<Integer, Satellite? mapSatellite = new Hash Map<Integer, Satellite>(); 
private int mScaleLength = 25; 

private float mBorder = 0.9f; 

private int mDirection = -1024; 

private Paint mPaintSourth; 


public CompassView(Context context) í 
this(context, null); 


j 


public CompassView(Context context, AttributeSet attr) { 

super(context, attr); 

mContext = context; 

mPaintLine — new Paint(); 

mPaintLine.setAntiAlias(true); 

mPaintLine.setColor(Color. GREEN); 

mPaintLine.setStroke Width(2); 

mPaintLine.setStyle(Style.SSTROKE); 

mPaintText = new Paint(); 

mPaintText.setAntiA lias(true); 

mPaintText.setColor(Color.RED); 

mPaintText.setStrokeWidth(1); 

mPaintText.setStyle(Style.SSTROKE); 

mPaintText.setTextSize(28); 

mPaintAngle — new Paint(); 

mPaintAngle.setAntiA lias(true); 

mPaintAngle.setColor(Color.GRAY); 

mPaintAngle.setStroke Width( 1 ); 

mPaintAngle.setStyle(Style. STROKE); 

mPaintAngle.setTextSize(23); 

mPaintSourth — new Paint(); 

mPaintSourth.setAntiA lias(true); 

mPaintSourth.setColor(Color.RED); 

mPaintSourth.setStrokeWidth(4); 

mPaintSourth.setStyle(Style.STROKE); 

mCompassBg = BitmapFactory.decodeResource(getResources(), R.drawable.compass bg); 

mRectSrc = new Rect(0, 0, mCompassBg.getWidth(), mCompassBg.getHeight()); 

m$SatelliteChina = BitmapFactory.decodeResource(getResources(), R.drawable.satellite china); 

mSatellite America = BitmapFactory.decodeResource(getResources(), R.drawable.satellite america); 

méSatelliteRussia = BitmapFactory.decodeResource(getResources(), R.drawable.satellite russia); 
} 


@Override 
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protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) í 


; 


int width = View.MeasureSpec.getSize(widthMeasureSpec); 
int height = View.MeasureSpec.getSize(heightMeasureSpec); 
mWidth = getMeasuredWidth(); 
if (width < height) ( 
super.onMeasure(widthMeasureSpec, widthMeasureSpec); 
} else í 
super.onMeasure(heightMeasureSpec, heightMeasureSpec); 
j 
mRectDest = new Rect(0, 0, mWidth, m Width); 
mRectAngle = new RectF(mWidth/10, mWidth/10, mWidth*9/10, mWidth*9/10); 
mRectSourth = new RectF(mWidth*0.3f/10, mWidth*0.3f/10, mWidth*9.7f/10, mWidth*9.7f/10); 
Log.d(TAG, "mWidth-"--mWidth); 


@Override 
protected void dispatchDraw(Canvas canvas) { 


super.dispatchDraw(canvas); 
int radius = mWidth/2; 
int margin = radius/10; 
canvas.drawBitmap(mCompassBg, mRectSrc, mRectDest, new Paint()); 
canvas.drawCircle(radius, radius, radius*3/10, mPaintLine); 
canvas.drawCircle(radius, radius, radius*5/10, mPaintLine); 
canvas.drawCircle(radius, radius, radius*7/10, mPaintLine); 
canvas.drawCircle(radius, radius, radius*9/10, mPaintLine); 
canvas.drawLine(radius, margin, radius, mWidth-margin, mPaintLine); 
canvas.drawLine(margin, radius, mWidth-margin, radius, mPaintLine); 
// 画 罗盘 的 刻度 
for (int i=0; i<360; i+=30) í 
Path path = new Path(); 
path.addArc(mRectAngle, i-3, i3); 
int angle = (i+90)%360; 
canvas.draw TextOnPath(""-angle, path, 0, 0, mPaintAngle); 
canvas.drawLine(get Xpos(radius, angle, radius*mBorder), 
getYpos(radius, angle, radius*mBorder), 
getXpos(radius, angle, (radius-mScaleLength)*m Border), 
getYpos(radius, angle, (radius-mScaleLength)*mBorder), mPaintAngle); 
; 
/ 画 卫 星 分 布 图 
for (Map.Entry<Integer Satellite> item map : mapSatellite.entrySetO) í 
Satellite item = item map.getValue(); 
Bitmap bitmap; 
if (item.nation.equals(" rf Ed") í 
bitmap — mSatelliteChina; 
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} else if (item.nation.equals(" Ed") í 
bitmap = mSatelliteAmerica; 
} else if (item.nation.equals(" f£ Ei") í 
bitmap — mSatelliteRussia; 
1 else í 
continue; 
j 
float left = getXpos(radius, item.azimuth, radius*mBorder*getCos(item.elevation)); 
float top = get Ypos(radius, item.azimuth, radius*mBorder*getCos(item.elevation)); 
canvas.drawBitmap(bitmap, left-bitmap.getWidth()/2, top-bitmap.getHeight()/2, new Paint()); 


// 画 指南 针 
if (mDirection > -1024) í 


int angle = (-mDirection*450)76360; 
canvas.drawLine(getXpos(radius, angle, radius*mBorder), 
getYpos(radius, angle, radius*mBorder), 
getXpos(radius, angle, 0), getYpos(radius, angle, 0),mPaintSourth); 
canvas.drawLine(getXpos(radius, angle, radius*mBorder), 
getYpos(radius, angle, radius*mBorder), 
getXpos(radius, angle-10, radius*7/10), getYpos(radius, angle- 10, radius*7/10), 
mPaintSourth); 
canvas.drawLine(getXpos(radius, angle, radius*mBorder), 
getYpos(radius, angle, radius*mBorder), 
getXpos(radius, angle--10, radius*7/10), getYpos(radius, angle+10, radius*7/10), 
mPaintSourth); 
canvas.drawLine(getXpos(radius, angle-10, radius*7/10), 
getYpos(radius, angle-10, radius*7/10), 
getXpos(radius, angle*10, radius*7/10), getYpos(radius, angle+10, radius*7/10), 
mPaintSourth); 
Path path = new Path(); 
path.addArc(mRectSourth, angle-2, angle+2); 
canvas.draw TextOnPath("Bj", path, 0, 0, mPaintText); 


} else ( 


j 


canvas.draw Text(" JE", radius-15, margin-15, mPaintText); 


private float getXpos(int radius, int angle, double length) í 
return (float) (radius + getCos(angle) * length); 


h 


private float getYpos(int radius, int angle, double length) í 
return (float) (radius + getSin(angle) * length); 
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private double getSin(int angle) í 

return Math.sin(Math.PI*angle/180.0); 
} 
private double getCos(int angle) { 

return Math.cos(Math.PI*angle/180.0); 
} 


public void setSatelliteMap(Map-Integer, Satellite> map) í 
mapSatellite = map; 
invalidate(); 
i 
public void setDirection(int direction) { 
mDirection = direction; 
invalidate(); 


96 小 结 


本 章 主 要 阐述 了 手机 上 硬件 设备 的 使 用 介绍 与 操作 说 明 ， 包 括 摄像 头 的 用 法 〈 表 面 视图 、 
相机 、 纹 理 视 图 、 升 级 版 相机 ) 、 麦 克 风 的 用 法 〈 拖 动 条 、 音 量 控制 、 录 音 与 播音 、 录 像 与 放 
WO 、 传 感 器 的 用 法 (传感器 的 种 类 、 加 速度 传感器 、 指 南 针 、 计 步 器 和 感光 器 ) 、 手 机 定位 
的 用 法 (定位 的 原理 、 开 启 定 位 功能 、 获 取 定 位 信息 ) 。 最 后 设计 了 一 个 实战 项 目 “ 仿 微 信 的 
发 现 功能 ”, 在 该 项 目的 App 编码 中 ,实现 了 扫 一 扫 (扫描 二 维 码 ) 、 摇 一 摇 〈 博 饼 抽 大 奖 ) 、 
Wk Wk (卫星 浑 天 仪 》3 种 功能 。 另 外 ， 介 绍 了 卫星 导航 的 相关 知识 。 

通过 本 章 的 学 习 ， 读 者 应 能 掌握 以 下 5 种 开发 技能 : 

CD 学 会 操纵 相机 实现 拍照 功能 〈 含 单 拍 和 连 拍 ) o 

OD 学 会 操纵 相机 与 麦克 风 实 现 媒体 录制 功能 ( 含 录音 和 录像 )。 

(3) 学 会 音频 和 视频 的 播放 功能 。 

(D 学 会 常见 传感器 的 用 法 〈 含 加 速度 传感器 、 磁 场 传感器 、 计 步 传感器 等 ) 。 

(5) 学 会 如 何 获取 位 置信 息 《〈 含 卫星 定位 和 网 络 定 位 ) o 








"I 网络 通信 


本 章 介绍 App 开发 常用 的 一 些 网 络 通信 技术 ， 主 要 包 
括 如 何 使 用 多 线程 完成 异步 操作 、 如 何 进 行 HTTP 接口 调用 
与 图 片 获取 、 如 何 实现 文件 上 传 和 下 载 操 作 、 如 何 运用 
Socket 通信 技术 等 。 最 后 结合 本 章 所 学 的 知识 演示 一 个 实战 
项 目 “ 仿 手机 QQ 的 聊天 功能 ”的 设计 与 实现 。 





r. c 
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10.1 多 线程 


本 节 介 绍 多 线程 技术 在 App 开发 中 的 具体 运用 , 首先 说 明 如 何 利用 Message 配合 Handler 
完成 主线 程 与 分 线程 之 间 的 简单 通信 ; 然后 阐述 进度 对 话 框 的 用 法 ， 以 及 如 何 自 定义 实现 文本 
进度 条 与 文本 进度 圈 ; 接着 讲述 异步 任务 AsyncTask 的 具体 用 法 和 注意 事项 ; 最 后 分 析 异 步 服 
务 IntentService 的 实现 原理 和 开发 步骤 。 


10.1.1 消息 传递 Message 


为 了 使 App 运行 得 更 流畅 ， 多 线程 技术 被 广泛 应 用 于 App 开发 。 由 于 Android 系统 存在 
限制 ， 只 有 主线 程 才能 直接 操作 界面 ， 因 此 分 线程 想 修改 界面 就 得 另 想 办 法 。 第 9 章 在 介绍 摄 
像 头 拍照 时 提 到 为 了 让 分 线程 能 够 刷新 界面 ，Android 专门 设计 了 表面 视图 SurfaceView 给 分 
线程 操作 ， 后 来 又 增加 了 纹理 视图 TextureView， 也 是 给 分 线程 使 用 。 

多 线程 技术 并 非 单单 用 于 拍照 预览 ， 还 用 于 网 络 通信 、 后 台 服 务 等 耗 时 场合 ， 并 且 这 些 

合 往往 希望 操纵 现 有 的 界面 , 而 不 是 操纵 表面 视图 。 这 要 求 有 一 种 用 于 线程 之 间 相互 通信 的 
机 制 。 大 家 都 知道 ， 主 线程 向 分 线程 传递 消息 时 可 以 直接 在 分 线程 的 构造 函数 中 传递 参数 ， 然 
而 分 线程 向 主线 程 传递 消息 并 无 捷径 , 为 此 Android 设计 了 一 个 Message 消息 工具 , 通过 结合 
Handler 与 Message 可 简单 有 效 地 实现 线程 之 间 的 通信 。 

主线 程 与 分 线程 之 间 传递 消息 的 步骤 主要 有 4 步 ， 说 明 如 下 : 


1. 在 主线 程 中 构造 一 个 Handler 对 象 ， 并 启动 分 线程 


处 理 器 Handler 是 大 家 的 老 朋 友 了 ， 从 第 2 章 开始 ， 凡 是 需要 进行 延迟 处 理 的 场合 ， 基 本 
都 用 到 了 Handler。 特 别 是 在 第 6 章 ， 在 介绍 简单 动画 的 实现 时 还 专门 对 Handler+Runnable 组 
合 做 了 详细 说 明 。Thread 类 是 Runnable 接口 的 一 个 具体 实现 ，Handler 调用 Runnable 对 象 的 
各 种 post 方法 也 适用 于 Thread 对 象 。 启 动 分 线程 有 两 种 方式 ， 既 可 通过 Handler 对 象 的 post 
方法 启动 Thread， 也 可 直接 调用 Thread 对 象 的 start 方法 。 


2. 在 分 线程 中 构造 一 个 Message 对 象 的 消息 包 


Message 是 多 线程 通信 中 存放 消息 的 包 庄 ,作用 类 似 于 Intent 机 制 的 Bundle 工具 。 实例 可 
通过 自身 的 obtain 方法 获得 ， 也 可 通过 Handler 对 象 的 obtainMessage 方法 获得 。 
下 面 来 看 Message 类 的 主要 参数 说 明 。 
what: 整 型 的 消息 标识 ， 用 于 标识 本 次 消息 的 唯一 编号 。 
argl: 整 型 数 ， 可 存放 消息 的 处 理 结果 。 
arg2: 整 型 数 ， 可 存放 消息 的 处 理 代码 。 
obj: Object 类 型 ， 可 存放 返回 消息 的 数据 结构 。 
replyTo: Messenger 类 型 ， 回 应 信使 ， 在 跨 进 程 通信 中 使 用 ， 多 线程 通信 用 不 着 。 


* 353 * 
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3. 在 分 线程 中 通过 Handler 对 象 将 Message 消息 发 出 去 

处 理 器 Handler 的 消息 发 送 操作 主要 是 各 类 send 方法 。 下 面 介绍 相关 方法 说 明 。 
obtainMessage: 获取 当前 消息 的 对 象 。 

sendMessage: 立即 发 送 消息 。 

sendMessageDelayed: 延迟 一 段 时 间 后 发 送 消 息 。 
sendMessageAtTime: 在 指定 时 间 点 发 送 消息 。 
sendEmptyMessage: 立即 发 送 空 消 息 。 
sendEmptyMessageDelayed: 延迟 一 段 时 间 后 发 送 空 消息 。 
sendEmptyMessageAtTime: 在 指定 时 间 点 发 送 空 消息 。 
removeMessages: 从 消息 队列 中 根据 指定 标识 移 除 对 应 消息 。 
hasMessages: 判断 消息 队列 中 是 否 存在 指定 标识 的 消息 。 


4. 主线 程 中 的 Handler 对 象 处 理 接收 到 的 消息 


主线 程 处 理 分 线程 发 出 的 消息 需要 实现 Handler 对 象 的 handleMessage 方法 ,根据 Message 
消息 的 具体 内 容 分 别 进行 相应 处 理 。 注意 , 因为 handleMessage 方法 处 于 主线 程 (UI 线程) 中， 
所 以 该 方法 内 部 可 以 直接 操作 界面 元 
下 面 是 利用 多 线程 实现 新 闻 滚 动 的 完整 代码 ， 结 合 使 用 了 Handler 与 Message, 
public class MessageActivity extends AppCompatActivity implements OnClickListener í 
private TextView tv message; 
private boolean bPlay — false; 
private int BEGIN = 0, SCROLL = 1, END = 2; 








@Override 
protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity message); 
tv message = (TextView) findViewById(R.id.tv message); 
tv message.setGravity(Gravity. LEFT|Gravity.BOTTOM); 
tv message.setLines(8); 
tv message.setMaxLines(8); 
tv message.setMovementMethod(new ScrollingMovementMethod()); 
findViewByld(R.id.btn start message).setOnClickListener(this); 
findViewByld(R.id.btn stop message).setOnClickListener(this); 
} 


@Override 
public void onClick(View v) { 
if (v.getId() = R.id.btn_start_message) í 
if (bPlay != true) { 
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bPlay = true; 
new PlayThread().start(); 
D 
} else if (v.getld() = R.id.btn stop message) í 
bPlay — false; 
; 
} 


private String[] mNewsArray = { "PERR RERE — S 38AR, SORGE RC, 
"美国 大 选 顺利 闭幕 ， 特 朗 普 高 票 当 选 ", "越南 撤销 日 本 获得 订单 的 核电 站 计划 "， 
"上 海 建成 卓越 全 球 城市 ， 新 市 镇 轨 交 全 覆盖 ", "土耳其 老人 怀抱 受伤 山羊 错 跑 入 医院 急诊 室 " }; 
private class PlayThread extends Thread í 
@Override 
public void run() { 
mHandler.sendEmptyMessage(BEGIN); 
while (bPlay = true) í 
try ( 
sleep(2000); 
} catch (InterruptedException e) í 
e.printStackTrace(); 
j 
Message message — Message.obtain(); 
message.what = SCROLL; 
message.obj = mNewsArray[(int) (Math.random()*30%5)]; 
mHandler.sendMessage(message); 
j 
bPlay = true; 
try ( 
sleep(2000); 
) catch (InterruptedException e) í 
e.printStackTrace(); 
Í 
mHandler.sendEmptyMessage(END); 
bPlay = false; 


h 


private Handler mHandler = new Handler() í 
@Override 
public void handleMessage(Message msg) { 
String desc = tv_message.getText().toString(); 
if (msg.what = BEGIN) í 
desc = String. format("%s\n%s %s", desc, DateUtil.getNow Time(), "下 面 开始 播放 新 闻 "); 
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} else if (msg.what = SCROLL) { 
desc = String.format("?6sWn?6s %s", desc, DateUtil.getNowTime(), (String) msg.obj); 
} else if (msg.what = END) í 
desc = String.format("%s\n%s 96s", desc, DateUtil.getNowTime(), "新 闻 播 放 结束 , 谢 
谢 观看 "); 
; 
tv message.setText(desc); 


新 闻 滚 动 的 效果 如 图 10-1 与 图 10-2 所 示 。 其 中 ， 图 10-1 所 示 为 正在 播放 新 闻 的 界面 ， 
分 线程 每 隔 两 秒 添加 一 条 新 闻 ; 图 10-2 所 示 为 新 闻 播 放 结束 时 的 界面 ， 主 线程 收 到 分 线程 的 
END 消息 ， 在 界面 上 提示 用 户 “ 新 闻 播 放 结束 ， 谢 谢 观 看 ” 


network network 


开始 播放 新 闻 停止 播放 新 闻 开始 播放 新 闻 停止 播放 新 闻 


15:27:50 ERE ERE 


15:27:12 下 面 开始 播放 新 闻 

15:27:14 越南 撤销 日 本 获得 订单 的 核电 站 计划 

15:27:16 美国 大 选 顺利 闭幕 ， 特 朗 普 高 票 当选 

15:27:18 土耳其 老人 怀抱 受伤 山羊 措 跑 入 医院 急诊 室 15:28:04 新 闻 播 放 结束 ， 谢 谢 观看 





10-1 正在 播放 新 闻 的 界面 图 10-2 停止 播放 新 闻 的 界面 
10.1.2 ”进度 对 话 框 ProgressDialog 


有 时 ， 分 线程 在 处 理事 务 期 间 不 允许 用 户 继续 操作 界面 控件 ， 但 是 还 想 提示 用 户 “ 页 面 
正在 加 载 ， 请 耐心 等 待 ”之 类 信息 ， 必 要 时 还 会 告知 用 户 当前 的 处 理 进 度 ， 这 种 情况 就 会 用 到 
进度 对 话 框 ProgressDialog。 分 线程 正在 处 理 时 ， 界 面 弹 出 进度 对 话 框 ; 分 线程 处 理 结束 时 ， 
自动 关闭 进度 对 话 框 。 这 样 既 确保 分 线程 不 受 干扰 ， 又 缓解 了 用 户 的 焦急 等 待 。 

进度 对 话 框 继承 自 提醒 对 话 框 AlertDialog， 内 部 集成 了 进度 条 ProgressBar, BEMA 
AlertDialog 的 所 有 方法 ， 又 实现 了 ProgressBar 的 公开 API。 下 面 是 进度 对 话 框 的 常用 方法 。 


setTitle: 设置 对 话 框 的 标题 文本 。 

setMessage: 设置 对 话 框 的 消息 内 容 。 

setlcon: 设置 对 话 框 的 图 标 。 

setProgress: 设置 当前 进度 的 数值 。 

setSecondaryProgress: 设置 当前 第 二 进度 的 数值 。 

setMax: 设置 进度 条 的 最 大 进度 数值 。 

setProgressStyle: 设置 进度 条 的 样式 。 取 值 ProgressDialog. STYLE. SPINNER 表示 转圈 风 
É (默认 值 ) ， 取 值 ProgressDialog.STYLE_HORIZONTAL 表示 长 条 风格 。 

e show: 显示 对 话 框 。 需 要 在 各 属性 设置 完成 后 调用 show 方法 。 
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e isShowing: 判断 对 话 框 是 否 正在 显示 。 
e dismiss: 关闭 对 话 框 。 
e 静态 的 show 方法 : 简化 的 调用 方法 ， 一 名 代码 就 搞定 进度 对 话 框 的 设置 与 显示 。 可 同 
时 指定 标题 文字 和 消息 内 容 ， 进 度 条 样式 为 默认 的 转圈 ， 示 例 代码 如 下 : 
ProgressDialog.show(this, "请 稍 候 ", "正在 努力 加 载 页 面 "); 
下 面 是 使 用 进度 对 话 框 的 代码 片段 : 


private String[] descArray={" 圆 圈 进 度 ", "水 平 进度 条 "}; 
private int[] styleArray=[ProgressDialog.STYLE SPINNER, ProgressDialog.STYLE HORIZONTAL}; 
private class StyleSelectedListener implements OnItemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) í 
if (mProgressDialog = null || mProgressDialog.isShowing() != true) í 
mStyleDesc = descArray[arg2]; 
int style = styleArray[arg2]; 
if (style = ProgressDialog.STYLE SPINNER) í 
mProgressDialog = ProgressDialog.show(ProgressDialogActivity.this, 
"请 稍 候 ", "正在 努力 加 载 页面 "); 
mHandler.postDelayed(mCloseDialog, 1500); 
) else ( 
mProgressDialog = new ProgressDialog(ProgressDialogActivity.this); 
mProgressDialog.setTitle(" 请 稍 候 "); 
mProgressDialog.setMessage(" 正 在 努力 加 载 页 面 "); 
mProgressDialog.setMax(100); 
mProgressDialog.setProgressStyle(style); 
mProgressDialog.show(); 
new RefreshThread().start(); 


J 
public void onNothingSelected(AdapterView<?> arg0) í 


ji 
ii 
private Runnable mCloseDialog = new Runnable() { 
@Override 
public void run() { 
if (mProgressDialog.isShowing() = true) í 
mProgressDialog.dismiss(); 


tv_result.setText(DateUtil.getNowTime()+" "+mStyleDesc+" 加 载 完成 "); 
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private class RefreshThread extends Thread í 
(QOverride 
public void run() í 
for (int i-0; i<10; i++) í 
Message message — Message.obtain(); 
message.what — 0; 
message.arg] = i*10; 
mHandler.sendMessage(message); 
try d 
sleep(500); 
} catch (InterruptedException e) í 
e.printStackTrace(); 
} 
5 
mHandler.sendEmpty Message( 1); 


1 


private Handler mHandler = new Handler() í 
@Override 
public void handleMessage(Message msg) { 
if (msg.what = 0) { 
mProgressDialog.setProgress(msg.arg 1 ); 
) else if (msg.what = 1) { 
post(mCloseDialog); 
j 


h 
进度 对 话 框 的 展示 效果 如 图 10-3. 与 图 10-4 所 示 。 其 中 ， 图 10-3 所 示 为 转圈 进度 样式 ， 


对 话 框 在 1.5 秒 后 自动 关闭 ; 图 10-4 所 示 为 长 条 进度 样式 ， 每 隔 0.5 秒 进度 数值 增加 10, 在 5 
秒 后 关闭 对 话 框 。 


请 稍 候 


正在 努力 加 载 页 面 


30/100 





图 10-3 转圈 样式 的 进度 对 话 框 图 10-4 长 条 样式 的 进度 对 话 框 


当然 ，Android 默认 的 进度 条 并 不 好 看 ， 而 且 没 有 自 带 的 进度 文字 提示 ， 实 际 开发 中 往往 
要 重新 定制 , 使 之 符合 用 户 的 视觉 习惯 。 主 要 的 改造 方向 有 两 种 : 在 长 条 进度 中 增加 文字 说 明 
和 在 圆圈 进度 中 增加 文字 说 明 。 
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1. 在 长 条 样式 中 增加 文字 说 明 


修改 长 条 样式 的 展示 效果 可 通过 定义 层次 图 形 并 给 progressDrawable 属性 赋值 层次 图 形 
实现 ， 具 体 方法 参见 第 6 章 的 “6.4.2 进度 条 ProcessBar”。 如 果 想 在 进度 条 中 央 显 示 进 度 文 
字 ， 就 得 基于 ProgressBar 自 定义 一 个 进度 条 工具 ， 主 要 思路 是 在 onDraw 方法 中 调用 canvas 
的 drawText 方法 往 进度 条 上 添加 指定 文本 。 

具体 的 代码 实现 不 难 ， 读 者 可 尝试 自行 编码 ， 也 可 参考 本 书 的 下 载 资源 。 文 字 进 度 条 的 
显示 效果 如 图 10-5 与 图 10-6 所 示 。 其 中 ， 图 10-5 是 进度 为 40% 时 的 界面 ， 图 10-6 是 进度 为 
80% 时 的 界面 。 


network network 


请 选择 进度 值 80 


当前 处 理 进度 为 80% 





图 10-5 进度 为 40% 的 进度 条 图 10-6 ”进度 为 80% 的 进度 条 
2. 在 圆圈 进度 中 增加 文字 说 明 


与 长 条 进度 相 比 ，App 使 用 圆圈 进度 更 加 常见 ， 可 是 ProgressBar 的 圆圈 样式 无 法 设 定 具 
体 的 进度 值 ， 若 要 采用 圆圈 进度 ， 则 必须 完全 气 弃 ProgressBar， 从 头 实现 自 定义 的 圆圈 进度 
工具 。 如 果 读 者 已 仔细 阅读 本 书 前 面 的 章节 ,相信 你 已 经 有 了 大 概 思路 ， 就 是 利用 第 6 章 的 自 
定义 圆 弧 动画 (参见 “6.2.3 圆 弧 进度 动画 ”) 先 画 个 背景 圆 环 ， 再 根据 进度 比例 画 个 前 景 圆 
弧 ， 最 后 在 圆心 处 添加 进度 文本 。 

具体 的 实现 代码 不 再 更 述 ， 读 者 可 参照 以 上 思路 进行 编码 ， 也 可 参考 本 书 的 下 载 资源 ， 
自己 动手 实践 看 看 。 文 字 进 度 圈 的 显示 效果 如 图 10-7 与 图 10-8 所 示 。 其 中 ,图 10-7 是 进度 为 
30% 时 的 界面 ， 图 10-8 是 进度 为 70% 时 的 界面 。 








请 选择 进度 值 30 M 请 选择 进度 什 70 
30% ) 70% 
图 10-7 进度 为 30% 的 进度 圈 图 10-8 ”进度 为 70% 的 进度 圈 


10.1.3 ”异步 任务 AsyncTask 


Thread+Handler 方式 虽然 能 够 实现 多 线程 的 通信 人 处理, 但 是 写 起 代码 颇 为 麻烦 , 不 但 调用 
流程 很 烦琐 , 而 且 处 理 代码 跟 活 动 页 面 代码 混在 一 起 , 非常 不 宜 维护 。 基 于 以 上 问题 , Android 
提供 了 AsyncTask 这 个 轻 量 级 的 异步 任务 工具 ， 内 部 已 经 封装 好 Thread+Handler 的 线程 通信 
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机 制 ， 开 发 者 只 需 按部就班 地 编写 业务 代码 ， 无 须 关心 线程 通信 的 复杂 流程 。 AsyncTask 通常 
用 于 网 络 访问 操作 ， 包 括 HTTP 接口 调用 、 文 件 下 载 与 上 传 等 。 

AsyncTask 是 一 个 模板 类 CAsyncTask«Params, Progress, Result?) ， 从 它 派生 而 来 的 新 类 
需要 指定 模板 的 参数 类 型 。 下 面 来 看 模板 参数 说 明 。 


Params: 任务 启动 时 的 输入 参数 ， 比 如 HTTP 访问 的 URL 地 址 、 请 求 报 文 等 。 可 设置 为 
String 类 型 或 自 定义 的 数据 结构 。 

Progress: 任务 执行 过 程 中 的 进度 。 一 般 设置 为 Integer 类 型 ， 表 示 当 前 处 理 进 度 。 
Result: 任务 执行 完 的 结果 和 参数， 比如 HTTP 调用 的 执行 结果 、 返 回报 文 等 。 可 设置 为 
String 类 型 或 自 定义 的 数据 结构 。 


开发 者 自 定义 的 任务 类 需要 实现 以 下 方法 。 


onPreExecute: 准备 执行 任务 时 触发 。 该 方法 在 doInBackground 方法 执行 之 前 调用 。 
doInBackground: 在 后 台 执 行 的 业务 处 理 。 网 络 请 求 等 异步 处 理 操作 都 放 在 该 方法 中 ， 
输入 参数 对 应 execute 方法 的 输入 参数 ， 输 出 参数 对 应 onPostExecute 方法 的 输入 参数 。 
注意 ， 该 方法 运行 于 分 线程 ， 不 能 操作 界面 ， 其 他 方法 都 能 操作 界面 。 
onProgressUpdate: 在 doInBackground 方法 中 调用 publishProgress 方法 时 触发 。 该 方法 通 
常用 于 在 处 理 过 程 中 刷新 进度 条 。 

onPostExecute: 任务 执行 完成 时 触发 ， 方 法 内 部 可 在 页 面 上 显示 处 理 结果 。 该 方法 在 
doInBackground 方法 执行 完毕 后 调用 ， 输 入 参数 对 应 doInBackground 方法 的 输出 参数 。 
onCancelled :调用 任务 对 象 的 cancel 方法 时 触发 。 表 示 取 消 任务 并 返回 。 


另外 ，AsyncTask 有 如 下 可 直接 调用 的 启 停 方法 。 


* 360 - 


execute: 开始 执行 异步 处 理 任务 。 
executeOnExecutor: 以 指定 的 线程 池 模式 执行 任务 。AsyncTask 内 置 的 线程 池 模式 有 以 
下 两 个 . 
> AsyncTask. THREAD POOL EXECUTOR: 表示 异步 线程 池 (各 任务 间 没 有 先后 顺序 ， 即 
有 可 能 某 任务 在 后 面 调用 却 先 执行 )。 
> AsyncTask.SERIAL_EXECUTOR: 表示 同步 线程 池 ( 各 任务 按照 代码 调用 的 先后 顺序 依次 
排队 等 待 执行 )，execute 方法 默认 使 用 SERIAL_EXECUTOR。 
publishProgress: 更 新 进度 。 该 方法 只 能 在 doInBackground 方法 中 调用 ， 调 用 后 会 触发 
onProgressUpdate 方法 。 
get: 获取 处 理 结果 。 
cancel: 取消 任务 。 该 方法 调用 后 ，doInBackground 方法 中 的 处 理 可 能 不 会 马上 停止 ; 若 
想 立即 停止 处 理 ， 则 可 在 doInBackground 方法 中 加 入 isCancelled 的 判断 。 
isCancelled: 判断 该 任务 是 否 取消 。tmue 表示 取消 ，false 表示 未 取消 。 
getStatus: 获取 任务 状态 。 任 务 状 态 的 取 值 说 明 见 表 10-1。 





网 络 通信 第 10 E 





表 10-1 任务 状态 的 取 值 说 明 







AsyncTask.Status 类 的 任务 状态 所 处 时 刻 











PENDING onPreExecute 处 理 之 前 《正在 等 待 ) 
RUNNING 正在 执行 | onPreExecute, dolnBackground, onPostExecute 运行 期 间 











onPostExecute 处 理 结束 





FINISHED 





下 面 是 一 个 异步 加 载 请 求 任务 的 代码 : 


public class ProgressAsyncTask extends AsyncTask<String, Integer, String> í 
private String mBook; 
public ProgressAsyncTask(String title) í 
super(): 
mBook = title; 


@Override 
protected String dolnBackground(String... params) í 
int ratio = 0; 
for (; ratio <= 100; ratio += 5) í 
ty ( 
Thread.sleep(200); / 睡眠 200 毫秒 模拟 网 络 通信 处 理 
} catch (InterruptedException e) í 
e.printStackTrace(); 
b 
publishProgress(ratio); 
I 


return params[0]; 


(@Override 
protected void onPreExecute() { 
mListener.onBegin(mBook); 


(@Override 
protected void onProgressUpdate(Integer... values) í 
mListener.onUpdate(mBook, values[0], 0); 


@Override 
protected void onPostExecute(String result) { 


mListener.onFinish(result); 
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@Override 
protected void onCancelled(String result) { 
mListener.onCancel(result); 


private OnProgressListener mListener; 
public void setOnProgressListener(OnProgressListener listener) í 
mListener = listener; 


public static interface OnProgressListener í 
public abstract void onFinish(String result); 
public abstract void onCancel(String result); 
public abstract void onUpdate(String request, int progress, int sub progress); 
public abstract void onBegin(String request); 


j 
在 Activity 中 调用 异步 任务 的 完整 代码 如 下 : 


public class AsyncTaskActivity extends AppCompatActivity implements OnProgressListener í 
private TextView tv_async; 
private ProgressBar pb_async; 
private ProgressDialog mDialog; 
public int mShowMode; 
public int BAR HORIZONTAL = 1, DIALOG CIRCLE =2, DIALOG HORIZONTAL = 3; 


(à Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity async task); 
tv async = (TextView) findViewById(R.id.tv async); 
pb async = (ProgressBar) findViewByld(R.id.pb async); 
ArrayAdapter-String^ styleAdapter = new ArrayAdapter-String»(this, 

R.layout.item select, bookArray); 

Spinner sp style = (Spinner) findViewById(R.id.sp style); 
sp_style.setPrompt(" 请 选择 要 加 载 的 小 说 "); 
sp_style.setAdapter(styleAdapter); 
sp style.setOnItemSelectedListener(new StyleSelectedListener()); 
sp style.setSelection(0); 

} 

private String[] bookArray={" 三 国 演义 ", "西游 记 ", "红楼 梦 "}; 

private int[] styleArray={BAR HORIZONTAL, DIALOG CIRCLE, DIALOG HORIZONTAL}; 
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class StyleSelectedListener implements OnItemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View arg], int arg2, long arg3) í 
startTask(styleArray[arg? |, bookArray[arg2]); 
; 


public void onNothingSelected(AdapterView-?- arg0) í 
; 
} 


private void startTask(int mode, String msg) { 
mShowMode = mode; 
ProgressAsyncTask asyncTask = new ProgressAsyncTask(msg); 
asyncTask.setOnProgressListener(this); 
asyncTask.execute(msg); 

1 


private void closeDialog() í 
if (mDialog != null && mDialog.isShowing() — true) í 
mDialog.dismiss(); 


} 


(@Override 

public void onFinish(String result) í 
String desc = String.format(" 您 要 阅读 的 《%s》 已 经 加 载 完毕 ", result); 
tv async.setText(desc); 
closeDialog(); 

} 

@Override 

public void onCancel(String result) { 
String desc = String.format(" 您 要 阅读 的 《%s》 已 经 取消 加 载 ", result); 
tv async.setText(desc); 
closeDialog(); 

$ 


@Override 
public void onUpdate(String request, int progress, int sub_progress) { 
String desc = String.format("%s 当前 加 载 进 度 为 %d%%", request, progress); 
tv async.setText(desc); 
if (mShowMode — BAR. HORIZONTAL) í 
pb async.setProgress(progress); 
pb async.setSecondaryProgress(sub progress); 
} else if (mShowMode = DIALOG HORIZONTAL) í 
mbDialog.setProgress(progress); 
mbDialog.setSecondaryProgress(sub progress); 
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J 
H 


@Override 
public void onBegin(String request) { 
tv_async.setText(requestt" 开 始 加 载 "); 
if (mDialog == null || mDialog.isShowing() != true) í 
if (mShowMode — DIALOG CIRCLE) í 
mDialog = ProgressDialog.show(this, " 稍 等 ", request+" 页 面 加 载 中 ……"); 
} else if (mShowMode == DIALOG HORIZONTAL) { 
mDialog = new ProgressDialog(this); 
mDialog.setTitle(" 稍 等 "); 
mDialog.setMessage(request+" 页 面 加 载 中 …*…"); 
mbialog.setIcon(R.drawable.ic search); 
mbDialog.setProgressStyle(ProgressDialog.STYLE HORIZONTAL); 
mDialog.show(); 


j 

Pt 2k hb FEB fE A Ac EROS VE MED 8 CHR hu fep m 
10-9, [E 10-10, K 10-11 所 示 。 其 中 ， 图 10-9 所 示 为 | 请 选择 要 加 载 的 小 说 
在 页 面 上 嵌入 进度 条 的 执行 界面 ， 图 10-10 所 示 为 圆圈 
样式 的 进度 对 话 框 执行 界面 ， 图 10-11 所 示 为 长 条 样式 
的 进度 对 话 框 执行 界面 。 图 10-9 异步 任务 结合 进度 条 的 界面 


三 国 演义 当前 加 载 进度 为 35% 





Q 稍 等 
红楼 梦 页 面 加 载 中 


西游 记 贡 面 加 载 中 


15/100 





图 10-10 异步 任务 结合 转圈 样式 的 界面 图 10-11 异步 任务 结合 长 条 样式 的 界面 


AsyncTask 在 简单 场合 已 经 足够 使 用 ， 如 果 要 用 于 大 量 并 发 处 理 ， 就 需要 十 分 小 心 ， 因 为 
AsyncTask 的 设计 不 其 完美 ， 使 用 过 程 中 要 注意 以 下 两 点 : 

(1) AsyncTask 默认 的 线程 池 模 式 是 SERIAL_EXECUTOR， 即 按照 先后 顺序 依次 调用 。 
假设 有 两 个 网 络 请 求 任务 , 第 一 个 是 文件 下 载 , 第 二 个 是 接口 调用 ,那么 接口 调用 任务 会 等 待 
文件 下 载 完毕 后 执行 ， 而 不 是 在 调用 时 立刻 执行 。 

(2) 由 于 顺序 模式 存在 排队 等 待 的 情况 ， 因 此 Android 提供 了 executeOnExecutor 方法 ， 
允许 开发 者 指定 任务 线程 池 。 不 过 AsyncTask 自 带 的 THREAD POOL EXECUTOR 也 存在 瓶 
颈 ， 该 线程 池 模 式 的 最 大 线程 个 数 是 CPU 个 数 的 两 倍 再 加 1 (参见 AsyncTask 的 源码 
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*MAXIMUM POOL SIZE = CPU COUNT * 2 +1” ) 。 如 果 用 户 手机 采用 了 双核 CPU, JE 
么 AsyncTask 的 最 大 并 发 线程 数 为 2*2+1=5 个 ， 此 时 若 并 发 任务 数 超过 5 个 ， 则 后 面 进来 的 
任务 只 能 排队 等 待 。 如 果 用 户 手机 采用 的 是 四 核 CPU，AsyncTask 的 最 大 并 发 线程 数 就 为 
4*2+1=9 个 ， 因 此 CPU 个 数 越 多 ，App 运行 越 流畅 是 有 软件 依据 的 。 


10.1.4 异步 服务 IntentService 


服务 Service 虽然 是 在 后 台 运 行 ， 但 跟 Activity 一 样 都 在 主线 程 中 ， 如 果 后 台 运 行 着 的 服 
务 挂 起 , 用 户 界面 就 会 卡 着 不 动 , 俗称 死机 。 后 台 服 务 经常 要 做 一 些 耗 时 操作 , 比如 批量 处 理 、 
文件 导入 、 网 络 访问 等 ， 此 时 不 应 该 影响 用 户 在 界面 上 的 操作 ， 而 应 该 开启 分 线程 执行 耗 时 操 
作 。 可 以 通过 Thread+Handler 机 制 实现 异步 处 理 ， 也 可 以 通过 Android 封装 好 的 异步 服务 
IntentService 处 理 。 

使 用 IntentService 有 两 个 好 处 ， 一 个 是 免 去 复杂 的 消息 通信 流程 ; 另 一 个 是 处 理 完成 后 无 
须 手 工 停止 服务 ， 开 发 者 可 集中 精力 进行 业务 逻辑 的 编码 。 话 虽 如 此 ,我 们 还 是 有 必要 了 解 一 
下 IntentService 的 具体 实现 ， 入 了 这 行 一 般 都 要 干 上 许多 年 ， 晚 学 不 如 早 学 。 前 面 提 到 ， 处 理 
器 对 象 位 于 主线 程 中 ， 分 线程 通过 Handler 对 象 通知 主线 程 ， 然 后 主线 程 执行 Handler 对 象 的 
handleMessage 方法 刷新 界面 。 反 过 来 也 是 允许 的 ， 即 处 理 器 对 象 位 于 分 线程 中 ， 主 线程 通过 
Handler 对 象 通知 分 线程 ， 然 后 分 线程 执行 Handler 对 象 的 handleMessage 方法 进行 耗 时 处 理 。 

具体 请 看 IntentService 的 实现 步骤 。 


CXJXov 创建 异步 服务 时 ,初始 化 分 线程 的 Handler 对 象 , 注意 下 面 源码 的 thread.getLooper 方法 : 


public void onCreate() í 
super.onCreate(); 
HandlerThread thread = new HandlerThread("IntentService[" + mName + "]"); 
thread.start(); 
mServiceLooper = thread.getLooper(); 
mServiceHandler = new ServiceHandler(mServiceLooper); 
j; 


ED 异步 服务 开始 运行 时 ， 通 过 Handler 对 象 将 请 求 数据 送 给 分 线程 ， 源 码 如 下 : 


public void onStart(Intent intent, int startld) í 
Message msg = mServiceHandler.obtainMessage(); 
msg.argl = startld; 
msg.obj = intent; 
mServiceHandler.sendMessage(msg); 

J 

C€X303 分 线程 在 Handler 对 象 的 handleMessage 方法 中 , 先 通过 onHandlelntent 方法 执行 具体 的 
务 处 理 ， 再 调用 stopSelf 结束 指定 标识 的 服务 。 源 码 如 下 : 
private final class ServiceHandler extends Handler í 


public ServiceHandler(Looper looper) í 
super(looper); 





lll 
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$ 

@Override 

public void handleMessage(Message msg) { 
onHandlelntent((Intent)msg.obj); 
stopSelf(msg.argl); 


j 


CD 增加 一 个 构造 方法 ， 并 分 配 内 部 线程 的 唯一 名 称 。 

(2) onStartCommand 方法 要 调用 父 类 的 onStartCommand， 因 为 父 类 方法 会 向 分 线程 传 

(3) 耗 时 处 理 的 业务 代码 要 写 在 onHandleIntent 方法 中 , 不 可 写 在 onStartCommand 方法 
中 。 因 为 onHandleIntent 方法 位 于 分 线程 ， 而 onStartCommand 方法 位 于 主线 程 。 

(4) IntentService 实现 了 onStart 方法 ， 却 未 实现 onBind 方法 ， 意 味 着 异步 服务 只 能 用 普 
通 方式 启 停 ， 不 能 用 绑 定 方式 启 停 。 

下 面 是 使 用 异步 服务 的 代码 : 


public class AsyncService extends IntentService í 
private static final String TAG = "AsyncService"; 
public AsyncService() í 
super("com.example.network.service.AsyncService"); 


j 


(@Override 
public int onStartCommand(Intent intent, int flags, int startid) í 
Log.i(TAG, "onStartCommand"); 
// 试 试 在 onStartCommand 里 调用 Thread.sleep 方法 ， 页 面 按钮 是 不 是 无 法 点 击 了 
return super.onStartCommand(intent, flags, startid); 
} 
@Override 
protected void onHandlelIntent(Intent intent) í 
Log.d(TAG, "begin onHandleIntent"); 
/在 onHandlelntent 中 执行 耗 时 任务 ， 不 会 影响 页 面 的 处 理 
try{ 
Thread.sleep(30*1000); 
} catch (InterruptedException e) í 
e.printStack Trace(); 
] 
Log.d(TAG, "end onHandlelIntent"); 
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异步 服务 的 演示 效果 如 图 10-12 所 示 , 即使 异步 
服务 在 onHandleIntent 方法 中 睡眠 30 秒 ， 也 丝毫 不 
影响 用 户 在 页 面 上 的 点 击 操作 。 读 者 可 以 尝试 在 SOPERNNNEUS 

onStartCommand 方法 中 睡眠 30 秒 , AARTEN leenman i P MATS , TEN 
上 正常 点 击 按钮 。 























图 10-12 异步 服务 的 演示 效果 图 


10.2 HTTP 接口 访问 


本 节 介 绍 HTTP 接口 访问 的 相关 技术 与 具体 使 用 ， 首 先 说 明 如 何 利 用 连接 管理 器 
ConnectivityManager 检测 网 络 连接 的 状态 ; 然后 阐述 App 用 于 接口 调用 的 移动 数据 格式 JSON 
的 构建 与 解析 ;接着 举例 说 明 通过 HttpURLConnection 实现 基本 的 接口 调用 ,包括 GET 和 POST 
两 种 常见 的 调用 方式 ， 并 给 出 阶段 性 实战 项 目 “ 根 据 经 纬度 获取 地 址 信息 ”的 实现 过 程 ; 最 后 
讲述 利用 HttpURLConnection 从 网 络 获取 小 图 片 的 方法 。 


10.2.1 网 络 连接 检查 


谈 到 网 络 通信 ， 首 先 要 检查 当前 是 否 处 于 上 网 状态 ， 然 后 进行 网 络 访问 操作 。 如 果 当 前 
网 络 连接 不 可 用 ， 那 么 无 须 执行 网 络 访问 ， 直 接 提示 用 户 “请 开启 网 络 连接 ”就 好 了 。 要 检测 
网 络 连接 ，Android 会 要 求 App 具备 上 网 权限 ， 所 以 首先 打开 AndroidManifestxml， 加 上 下 面 
几 行 网 络 权限 配置 : 
<!-- 互联 网 --> 
<uses-permission android:name="android.permission.INTERNET" /> 
<!-- 查看 网 络 状态 -> 
<uses-permission android:name="android.permission.ACCESS_NETWORK STATE" > 
<uses-permission android:name="android.permission.ACCESS_WIFI STATE" > 
添加 网 络 权 限 配置 后 ， 可 利用 连接 管理 器 ConnectivityManager 检测 网 络 连接 ， 该 工具 的 
对 象 从 系统 服务 Context. CONNECTIVITY SERVICE 中 获取 。 调 用 连接 管理 器 对 象 的 
getActiveNetworkInfo 方法 , 返回 一 个 NetworkInfo 实例 , 通过 该 实例 可 获取 详细 的 网 络 连接 信 
息 。 下 面 是 NetworkInfo 的 常用 方法 。 


e getType: 获取 网 络 类 型 。 网 络 类 型 的 取 值 说 明 见 表 10-2. 
表 10-2 网络 类 型 的 取 值 说 明 











ConnectivityManager 类 的 网 络 类 型 说 明 
TYPE WIFI wifi 
TYPE MOBILE 数据 连接 
TYPE WIMAX wimax 
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( 续 表 ) 
ConnectivityManager 类 的 网 络 类 型 说 明 
TYPE ETHERNET 以 太 网 
TYPE BLUETOOTH 蓝牙 
TYPE VPN vpn 





e getState: 获取 网 络 状态 。 网 络 状态 的 取 值 说 明 见 表 10-3. 
表 10-3 ”网 络 状态 的 取 值 说 明 




















Networklnfo.State 的 网 络 状态 说 明 
CONNECTING 正在 连接 
CONNECTED 已 连接 
SUSPENDED 挂 起 
DISCONNECTING 正在 断 开 
DISCONNECTED BF 
UNKNOWN ES: 





e getSubtype: 获取 网 络 子 类 型 。 当 网 络 类 型 为 数据 连接 时 ， 子 类 型 为 2G/3G/4G 的 细 分 类 
型 ， 如 CDMA、EVDO、HSDPA、LTE 等 。 网 络 子 类 型 的 取 值 说 明 见 表 10-4. 


表 10-4 ”网 络 子 类 型 的 取 值 说 明 















































取 值 TelephonyManager 类 的 网 络 子 类 型 制式 分 类 
1 NETWORK TYPE GPRS 2G 
2 NETWORK TYPE EDGE 2G 
3 NETWORK TYPE UMTS 3G 
4 NETWORK TYPE CDMA 2G 
5 NETWORK TYPE EVDO 0 3G 
6 NETWORK TYPE EVDO A 3G 
7 NETWORK TYPE IxRTT 2G 
8 NETWORK TYPE HSDPA 3G 
9 NETWORK TYPE HSUPA 3G 
10 NETWORK TYPE HSPA 3G 
11 NETWORK TYPE IDEN 2G 
12 NETWORK TYPE EVDO B 3G 
13 NETWORK TYPE LTE 4G 
14 NETWORK TYPE EHRPD 3G 
15 NETWORK TYPE HSPAP 3G 
16 NETWORK TYPE GSM 2G 
17 NETWORK TYPE TD SCDMA 3G 
18 NETWORK TYPE IWLAN 4G 
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网 络 连接 的 检测 结果 如 图 10-13 和 图 10-14 所 示 。 其 中 ， 图 10-13 表示 当前 处 于 WIFI 环 
境 ， 图 10-14 表示 当前 使 用 4G 类 型 的 数据 连接 上 网 。 


network network 


当前 网 络 连接 的 状态 是 已 连接 
当前 联网 的 网 络 类 型 是 WIFI 


图 10-13 连接 WIFI 的 检测 结果 图 图 10-14 数据 连接 的 检测 结果 图 
10.2.2 ”移动 数据 格式 JSON 


当前 网 络 连接 的 状态 是 已 连接 
当前 联网 的 网 络 类 型 是 LTE 4G 





网 络 通信 的 交互 数据 格式 有 两 大 类 ， 分 别 是 JSON 和 XML， 前 者 短小 精 悍 ， 后 者 表现 力 
丰富 。 对 于 App 来 说 ， 基 本 采用 JSON 格式 与 服务 器 通信 。 原 因 很 多 ， 一 个 是 手机 流量 很 贵 ， 
表达 同样 的 信息 ，JSON 串 比 XML 串 短 很 多 ， 在 节省 流量 方面 占 了 上 风 ， 另 一 个 是 JSON E 
解析 得 更 快 ， 也 更 省 电 ，XML 不 但 慢 而 且 耗 电 。 于 是 ，JSON 格式 成 了 移动 端 事 实 上 的 网 络 
数据 格式 标准 。 

Android 自 带 JSON 解析 工具 ， 提 供 对 JSONObject (JSON 对 象 ) 和 JSONArray (JSON 
数组 ) 的 解析 处 理 。 

1. JSONObject 

下 面 来 看 JSONObject 的 常用 方法 。 

JSONObject 构造 函数 : 从 指定 字符 串 构造 一 个 JSONObject 对 象 。 
getJSONObject: 获取 指定 名 称 的 JSONObject 对 象 。 

getString: 获取 指定 名 称 的 字符 串 。 

getint: 获取 指定 名 称 的 整 型 数 。 

getDouble: 获取 指定 名 称 的 双 精 度数 。 

getBoolean: 获取 指定 名 称 的 布尔 数 。 

geUSONArray: 获取 指定 名 称 的 JSONArray 数组 对 象 。 

put: 添加 一 个 JSONObject 对 象 。 

toString: 把 当前 的 JSONObject 对 象 输出 为 一 个 JSON 字符 串 。 


2. JSONArray 
下 面 来 看 JSONArray 的 常用 方法 。 


e length: 获取 JSONArray 数组 的 长 度 。 

e getJSONObject: 获取 JSONArray 数组 在 指定 位 置 的 JSONObject 对 象 。 

e put: 往 JSONArray 数组 中 添加 一 个 JSONObject 对 象 。 

下 面 是 使 用 JSON 串 的 代码 片段 ， 包 括 如 何 构造 JSON 串 和 如 何 解析 JSON 串 : 


// 构造 JSON Ë 
private String getJsonStr() í 
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String str = ""; 
JSONObject obj = new JSONObject(); 
try { 
obj.put("name", "address"); 
JSONArray array = new JSONArray(); 
for (int i = 0; i < 3; i) í 
JSONObject item = new JSONObject(); 
item.put("item", "第 " + (i + 1) + "个 元 素 "); 
array.put(item); 
D 
obj.put("list", array); 
obj.put("count", array.length()); 
obj.put("desc", "这 是 测试 串 "); 
str = obj.toString(); 
} catch (JSONException e) í 


e.printStackTrace(); 
j 
return str; 
j 
/ 解析 JSON 串 


private String parserJson(String jsonStr) í 
String result = ""; 
try ( 
JSONObject obj = new JSONObject(jsonStr); 
String name = obj.getString("name"); 
String desc = obj.getString("desc"); 
int count — obj.getInt("count"); 
result = String.format("%sname=%s\n", result, name); 
result = String.format("?6sdesc-?6s n", result, desc); 
result = String. format("%scount=%d\n", result, count); 
JSONAmay listArray = obj.getJSONArray("list"); 
for (int i-0; i«listArray.length(); i++) f 
JSONObject list item = listArray.getJSONObject(i); 
String item — list item.getString("item"); 
result = String.format("%s\titem=%s\n", result, item); 
; 
} catch (JSONException e) í 
e.printStack Trace(); 
i 


return result; 


IC TAURI 
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示例 代码 对 应 的 效果 如 图 10-15 和 图 10-16 所 示 。 其 中 ， 图 10-15 所 示 为 构造 JSON 串 的 
结果 界面 ， 图 10-16 所 示 为 解析 JSON 串 的 结果 界面 。 








构造 JSON 串 解析 JSON 串 遍历 JSON 串 构造 JSON 串 解析 JSON 串 遍历 JSON 串 
("count"3,"list"[(item":"88 1 4-75 E"), item": $824 7c name-address 
素 "),{"item":" 第 3 个 元 素 中 "desc"." 这 是 测试 desc= 这 是 测试 串 
@","name":"address”} count=3 








图 10-15 ”构造 JSON 串 的 结果 图 图 10-16 解析 JSON 串 的 结果 图 


10.2.3 HTTP 接口 调用 


HTTP 接口 调用 的 代码 标准 有 两 个 , 分 别 是 HttpURLConnection 与 HttpClient。 就 像 JSON 
与 XML 的 区 别 一 样 ， 移 动 端的 代码 标准 基本 采用 更 轻 量 级 的 HttpURLConnection。 只 使 用 
HttpURLConnection 就 能 玩 转 几乎 所 有 HTTP 访问 ， 当 然 复 杂 的 功能 〈 如 分 段 传输 、 上 传 等 ) 


得 自己 写 代 码 细节 。 
HttpURLConnection 对 象 从 URL 对 象 的 openConnection 方法 获得 。 下 面 来 看 该 对 象 的 常 
用 方法 。 


setRequestMethod: 设置 请 求 类 型 。GET 表示 get iñ R, POST 表示 post 请 求 。 
setConnectTimeout: 设置 连接 的 超时 时 间 。 

setReadTimeout: 设置 读 取 的 超时 时 间 。 

setRequestProperty: 设置 请 求 包头 的 属性 信息 。 

setDoOutput: 设置 是 否 允 许 发 送 数据 。 如 果 用 到 getOutputStream 方法 ，setDoOutput 就 
必须 设置 为 rue。 因 为 POST 方式 肯定 会 发 送 数据 ， 所 以 POST 调用 时 必须 设置 该 方法 。 
getOutputStream: 获取 HTTP 输出 流 。 调 用 该 函数 返回 一 个 OutputStream 对 象 ， 接 着 依 
次 调用 该 对 象 的 write 和 flush 方法 写 入 要 发 送 的 数据 。 

connect: 建立 HTTP 连接 。 该 方法 在 getOutputStream 后 调用 ,在 getInputStream 前 调用 。 
setDoInput: 设置 是 否 允 许 接收 数据 。 如 果 用 到 getInputStream 方法 ，setDoInput 就 必须 
设置 为 true (其实 也 不 必 手 动 设置 ， 因 为 默认 就 是 true) 。 

getlnputStream: 获取 HTTP 输入 流 。 调 用 该 函数 返回 一 个 InputStream 对 象 ， 接 着 调用 
该 对 象 的 read 方法 读 出 接收 的 数据 。 

getResponseCode: 获取 HTTP 返回 码 。 

getHeaderField: 获取 应 答 数据 包头 的 指定 属性 值 。 

getHeaderFields: 获取 应 答 数据 包头 的 所 有 属性 列表 。 

disconnect: WJF HTTP 连接 。 











HTTP 接口 调用 主要 有 GET 和 POST 两 种 方式 ，GET 方式 只 是 简单 的 数据 获取 操作 ， 类 
似 于 数据 库 的 查询 操作 ; POST 方式 有 提交 具体 的 表单 信息 ， 类 似 于 数据 库 的 增 、 删 、 改 操作 。 
两 种 接口 调用 都 有 固定 的 代码 模板 ， 直 接 套用 即 可 。 下 面 是 HTTP 接口 调用 的 代码 : 








.371， 
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// 设 置 默认 的 连接 属性 信息 
private static void setConnHeader(HttpURL Connection conn, String method, HttpReqData req data) 
throws ProtocolException í 
conn.setRequestMethod(method); 
conn.setConnectTimeout(5000); 
conn.setReadTimeout(10000); 
conn.setRequestProperty(" Accept", "*/*"); 
conn.setRequestProperty("Accept-Language", "zh-CN"); 
conn.setRequestProperty("Accept-Encoding?", " 
if (req data.content type.equals("") != true) í 
conn.setRequestProperty("Content-Type", req data.content type); 


'gzip, deflate"); 


liget 文本 数据 
public static HttpRespData getData(HttpReqData req_data) { 
HttpRespData resp data = new HttpRespData(); 
ty { 
URL url = new URL(req_data.url); 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
setConnHeader(conn, "GET", req data); 
conn.connect(); 
resp data.content — StreamTool.getUnzipStream(conn.getInputStream(), 
conn.getHeaderField("Content-Encoding"), req data.charset); 
resp data.cookie = conn.getHeaderField("Set-Cookie"); 
conn.disconnect(); 
) catch (Exception e) í 
e.printStackTrace(); 
resp data.err msg = e.getMessage(); 
j 
return resp data; 


//post 的 内 容 放 在 url 中 
public static HttpRespData postUrl(HttpReqData req data) í 
HttpRespData resp data = new HttpRespData(); 
Strings url = req data.url; 
if (req data.params !- null) í 
S url += "?" + req data.params.toString(); 
; 
Log.d(TAG, "s url-"*s url); 
try{ 
URL url = new URL(s url); 
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HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
setConnHeader(conn, "POST", req data); 
conn.setDoOutput(true); 
conn.connect(); 
resp data.content — StreamTool.getUnzipStream(conn.getInputStream(), 
conn.getHeaderField("Content-Encoding"), req data.charset); 

resp data.cookie — conn.getHeaderField("Set-Cookie"); 
conn.disconnect(); 

} catch (Exception e) í 
e.printStackTrace(); 
resp data.err msg — e.getMessage(); 

i 


return resp_data; 


/post 的 内 容 放 在 输出 流 中 
public static HttpRespData postData(HttpReqData req data) í 

req data.content type = "application/x-www-form-urlencoded"; 

HttpRespData resp data = new HttpRespData(); 

Strings url = req data.url; 

Log.d(TAG, "s url-"*s url", params-"*req data.params.toString()); 

try ( 
URL url = new URL(s url); 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
setConnHeader(conn, "POST", req data); 
conn.setDoOutput(true); 
conn.setDolInput(true); 
conn.connect(); 
PrintWriter out = new PrintWriter(conn.getOutputStream()); 
out.print(req data.params.toString()); 
out.flush(); 
resp data.content — StreamTool.getUnzipStream(conn.getInputStream(), 

conn.getHeaderField("Content-Encoding"), req data.charset); 

resp data.cookie — getRespCookie(conn, req data); 
conn.disconnect(); 

} catch (Exception e) í 
e.printStackTrace(); 
resp data.err msg = e.getMessage(); 

i 

return resp_data; 
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正 所 谓 好 事 多 磨 ，HTTP 访问 除了 套用 调用 模板 外 ， 还 要 处 理 好 几 种 特殊 情况 ， 否 则 就 不 
会 正常 工作 。 常 见 的 特殊 情况 有 两 种 : URL 串 中 对 汉字 的 转 义 处 理 和 返回 内 容 为 压缩 数据 时 
的 解压 处 理 。 


1. URL 串 中 对 汉字 的 转 义 处 理 


使 用 GET 方式 传递 请 求 数据 ,参数 放 在 URL 中 直接 传送 过 去 。 如 果 参 数值 有 汉字 ， 就 进 
行 UTF8 编码 转 义 处 理 ， 比 如 “你 ”要 转 为 “%E4%BD%A0”。 同 理 ， 对 于 服务 器 返回 的 UTF8 
编码 也 要 进行 反 转 义 ， 比 如 “%E4%BD%A0” 要 转 为 “你 ”。 具 体 的 转 义 代码 参见 本 书 下 载 
资源 的 URLtoUTF8.java。 


2. 返回 内 容 为 压缩 数据 时 的 解压 处 理 


HTTP 请 求 的 包头 带 有 Accept-Encoding: gzip,deflate, 表示 客 户 端 支 持 gzip 压缩 。 服务器 
可 能 返回 gzip 压缩 的 应 答 数据 ， 此 时 应 答 包头 中 会 有 Content-Encoding: gzip。 此 时 压缩 数据 
必须 先 解压 才能 正常 读 取 , 未 解压 只 会 读 到 一 堆 乱 码 。 输 入 流 的 gzip 解压 使 用 GZIPInputStream 
工具 类 ， 具 体 的 解压 代码 参见 本 书 下 载 资源 的 StreamTooljava。 

下 面 用 一 个 阶段 性 的 实战 小 项 目 练 练 手 。 第 9 章 在 介绍 定位 功能 时 使 用 定位 管理 器 获取 
手机 的 位 置信 息 ， 包括 经 度 、 纬 度 、 高 度 等 ， 不 过 用 户 关心 的 是 具体 的 地 址 描述 ， 而 不 是 看 不 
懂 的 经 纬度 。 现 在 我 们 利用 Google Map 的 开放 API， 通 过 HTTP 调用 传 入 经 纬度 的 数值 ， 然 
后 对 方 返回 一 个 JSON 格式 的 地 址 信息 字符 串 ， 通 过 解析 JSON 串 就 能 得 到 具体 的 地 址 。 

因为 网 络 访问 不 能 在 主线 程 中 进行 ,所 以 要 结合 AsyncTask 与 HttpURLConnection 实现 地 
址 的 异步 获取 。 获 取 地 址 信息 的 任务 代码 示例 如 下 : 
public class GetAddressTask extends AsyncTask<Location, Void, String> { 
private final static String TAG = "GetAddressTask"; 
private static String mAddressUrl = "http://maps.google.cn/maps/api/geocode/json?latIng- {0}, 
11] &sensor-true&language-zh-CN"; 
public GetAddressTask() í 
super(); 














j 


(@Override 
protected String doInBackground(Location... params) í 
Location location = params[0]; 
String url = MessageFormat.format(mA ddressUrl, location.getLatitude(), location.getLongitude()); 
HttpReqData req data = new HttpReqData(url); 
HttpRespData resp data — HttpRequestUtil.getData(req data); 
Log.d(TAG, "return json = " + resp. data.content); 


String address = "未 知 "; 
if(resp data.err msg.length() <= 0) í 
ty t 





网 络 通信 第 0X 





JSONObject obj = new JSONObject(resp data.content); 

JSONArray resultArray = obj.getjSONArray("results"); 

if (resultArray.length() > 0) í 
JSONObject resultObj = resultArray.getJjSONObject(0); 
address — resultObj.getString("formatted address"); 

; 

j catch (JSONException e) í 
e.printStackTrace(); 


; 
Log.d(TAG, "address = " + address); 
return address; 

} 


@Override 

protected void onPostExecute(String address) { 
mListener.onFindAddress(address); 

} 


private OnAddressListener mListener; 
public void setOnAddressListener(OnAddressListener listener) í 
mListener = listener; 


} 


public static interface OnAddressListener ( 
public abstract void onFindAddress(String address); 


j 


接着 在 原来 的 Activity 代码 中 启动 该 任务 , 并 实现 OnAddressListener 接口 的 onFindAddress 
方法 ， 即 可 在 页 面 上 添加 详细 的 地 址 信息 。 启 动 任务 的 代码 如 下 : 
GetAddressTask addressTask = new GetAddressTask(); 


addressTask.setOnAddressListener(this); 
addressTask.execute(location); 


定位 并 获取 地 址 信息 的 效果 如 图 10-17. 所 
示 。 此 时 除了 原来 的 经 纬度 数据 外 ， 还 多 了 一 个 
文字 表达 的 详细 地 址 ， 从 省 、 市 、 区 一 直到 具体 。 [ume : 

的 街道 和 门牌 号 。 如 此 一 来 ， 定 位 功能 的 实用 性 Rn a or 
其 中 高 度 : 0 米 ， 精度 : 1 米 


就 大 大 增强 了 。 其 中 地 址 ` 中 国 福建 省 福州 市 仓 山区 工农 
路 249 号 -375 号 








图 10-17 通过 HTTP 调用 获得 地 址 信息 的 效果 图 
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10.24 HTTP 图 片 获取 


除了 HTTP 接口 调用 外 , HttpURLConnection 还 可 用 于 获取 网 络 小 图 片 , 比如 验证 码 图片 、 
头像 图 标 等 ， 这 些小 图 不 大 ， 一 般 也 无 须 缓存 ， 可 直接 从 网 络 上 获取 最 新 的 图 片 。 
下 面 是 使 用 HttpURLConnection 获取 图 片 的 代码 : 


//get 图 片 数据 
public static HttpRespData getImage(HttpReqData req data) í 
HttpRespData resp data — new HttpRespData(); 
try ( 
URL url = new URL(req data.url); 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
setConnHeader(conn, "GET", req data); 
conn.connect(); 
InputStream is = conn.getInputStream(); 
resp data.bitmap = BitmapFactory.decodeStream(is); 
resp data.cookie = conn.getHeaderField("Set-Cookie"); 
conn.disconnect(); 
) catch (Exception e) í 
e.printStackTrace(); 
resp data.err msg = e.getMessage(): 
J 


return resp. data; 


j 


在 活动 页 面 与 HTTP 图 片 获取 之 间 还 需 一 个 基于 AsyncTask 的 图 片 获取 任务 做 桥梁 。 下 
面 是 获取 图 片 验证 码 的 任务 代码 : 


public class GetlmageCode Task extends AsyncTask<Void, Void, String> í 
private final static String TAG = "GetImageCodeTask"; 
private Context mContext; 
private String mImageCodeUrl = "http://220.160.54.47:82/)/SPORTLET/radomImage?x-"; 


public GetImageCodeTask(Context context) í 
super(); 
mContext = context; 


h 


(@Override 
protected String doInBackground( Void... params) í 
String url = mImageCodeUrl + DateUtil.getNowDateTime(null); 
Log.d(TAG, "image url="+url); 
HttpReqData req data = new HttpReqData(url); 
HttpRespData resp data — HttpRequestUtil.getImage(req data); 
String path = BitmapUtil.getCachePath(mContext) + DateUtil.getNowDateTimef(null) + ".jpg"; 
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BitmapUtil.saveBitmap(path, resp data.bitmap, "jpg", 80); 
Log.d(TAG, "image path="+path); 
return path; 

k 

@Override 

protected void onPostExecute(String path) { 
mListener.onGetCode(path); 

b 

private OnImageCodeListener mListener; 

public void setOnImageCodeListener( OnImageCodeL istener listener) í 
mListener = listener; 


j 


public static interface OnImageCodeListener í 
public abstract void onGetCode(String path); 


f 
下 面 是 在 页 面 代码 中 调用 验证 码 获 取 任 务 的 代码 片段 ， 首 先 指定 task 任务 ， 然 后 实现 
onGetCode 方法 显示 验证 码 图 片 : 





private void getImageCode() { 
if (bRunning != true) í 
bRunning = true; 
GetImageCodeTask codeTask = new GetlmageCodeTask(this); 
codeTask.setOnImageCodeL istener(this); 
codeTask.execute(); 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.iv image code) í 
getImageCode(); 


@Override 

public void onGetCode(String path) { 
Uri uri = Uri.parse(path); 
iv_image_code.setImageURI(uri); 
bRunning = false; 
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从 网 络 上 获取 并 显示 验证 码 图 片 的 效果 如 图 10-18 和 图 10-19 所 示 。 其 中 ， 图 10-18 所 示 
为 页 面 的 初始 界面 , 点 击 图 片 后 会 重新 加 载 验 证 码 ; 图 10-19 所 示 为 验证 码 图 片 刷新 后 的 界面 。 











点 击 验 证 码 即 可 刷新 验证 码 图 片 点 击 验证 码 即 可 刷新 验证 码 图 片 
9s 2 0o 2, 7. 
图 10-18 ”获取 验证 码 图 片 的 初始 页 面 图 10-19 验证 码 图 片 刷新 后 的 页 面 
103 ”上传 和 下 载 


本 节 介 绍 App 与 服务 器 之 间 上 传 文件 和 下 载 文件 的 实现 与 管理 ， 首 先 对 下 载 管理 器 
DownloadManager 进行 详细 说 明 ， 包 括 文件 下 载 的 3 个 步骤 、3 种 下 载 事件 以 及 下 载 进 度 的 两 
种 查看 方式 〈 通 知 栏 查 看 和 游标 轮 询 ) ; 然后 阐述 基于 Fragment 技术 的 文件 对 话 框 实现 ， 包 
括 文件 保存 对 话 框 和 文件 打开 对 话 框 两 种 形式 ; 最 后 介绍 通过 HttpURLConnection 的 POST X 
式 如 何 实现 文件 的 上 传 操作 ， 以 及 上 传 服务 器 的 简单 搭建 过 程 。 


10.3.1 下 载 管理 器 DownloadManager 
10.2 节 提 到 使 用 HttpURLConnection 可 以 获取 小 图 片 ， 不 过 这 么 做 有 诸多 限制 ， 比 如 : 


(1) 无 法 断 点 续 传 ， 一 旦 中 途 失 败 ， 只 能 从 头 开始 获 取 。 

(2) 只 能 获取 图 片 ， 不 能 获取 其 他 文件 。 

(3) 不 是 真正 意义 上 的 下 载 操 作 ， 没 法 设置 下 载 参数 。 

所 以 ，10.2 节 的 做 法 只 能 用 于 获取 小 图 ， 如 果 要 下 载 大 图 或 下 载 其 他 格式 的 文件 就 要 另 
想 办 法 。 因 为 下 载 功能 比较 常用 且 业 务 功能 相对 统一 ， 所 以 Android 从 2.3 CAPIO). 开始 提供 
了 专门 的 下 载 工具 DownloadManager 统一 管理 下 载 操作 。 

下 载 管 理 器 DownloadManager 的 对 象 从 系统 服务 Context. DOWNLOAD SERVICE 中 获 
取 ， 上 有 具体 使 用 过 程 分 为 3 步 : 构建 下 载 请 求 、 进 行 下 载 操作 和 查询 下 载 进度 。 

1. 构建 下 载 请 求 

要 想 使 用 下 载 功 能 ， 首 先 得 构建 一 个 下 载 请 求 ， 说 明 从 哪里 下 载 、 下 载 参 数 是 什么 、 下 
载 的 文件 保存 到 哪里 等 。 这 个 下 载 请 求 就 是 DownloadManager 的 内 部 类 Request。 下 面 来 看 该 
类 的 常用 方法 说 明 。 

e 构造 函数 : 指定 从 哪个 网 络 地 址 下 载 文件 。 


e setAllowedNetworkTypes: 指定 允许 下 载 的 网 络 类 型 .允许 网 络 类 型 的 取 值 说 明 见 表 10-5。 
若 同时 允许 多 种 网 络 类 型 ， 则 可 使 用 竖 线 “|” 把 多 种 网 络 类 型 拼接 起 来 。 





+ 378* 





网 络 通信 第 0X 





表 10-5 ”允许 网 络 类 型 的 取 值 说 明 











DownloadManager.Request 类 的 允许 网 络 类 型 说 明 
NETWORK WIFI WIFI 网 络 
NETWORK. MOBILE 数据 连接 网 络 
NETWORK BLUETOOTH 蓝牙 网 络 





e setDestinationInExternalFilesDir: 设置 下 载 文件 在 本 地 的 保存 路 径 。 第 二 个 参数 为 目录 类 

型 ， 取 值 说 明 见 第 4 章 的 表 4-2; 第 三 个 参数 为 不 带 斜 杆 的 文件 名 ; 另外 ， 如 果 指 定 目 

录 已 存在 同名 文件 ， 系 统 就 会 将 新 下 载 的 文件 重 命名 ， 即 在 文件 名 末尾 添加 “-1”“-2” 

之 类 的 序号 。 

addRequestHeader: 给 HTTP 请 求 添加 头 部 参数 。 

setMimeType: 设置 下 载 文件 的 媒体 类 型 .一般 无 须 设置 , 默认 是 服务 器 返回 的 媒体 类 型 。 

setTitle: 设置 通知 栏 上 的 消息 标题 。 如 果 不 设置 ， 默 认 标题 就 是 下 载 的 文件 名 。 

setDescription: 设置 通知 栏 上 的 消息 描述 。 如 果 不 设置 ， 就 默认 显示 系统 估算 的 下 载 剩 

余 时 间 。 

e setVisibleInDownloadsUi: 设置 是 否 显示 在 系统 的 下 载 页 面 上 。 

e setNotificationVisibility: 设置 通知 栏 的 下 载 任 务 可 见 类 型 。 可 见 类 型 的 取 值 说 明 见 表 
10-6。 


表 10-6 通知 可 见 类 型 的 取 值 说 明 

说 明 

隐藏 

下 载 时 可 见 〈 下 载 完 成 后 消失 ) 
下 载 进行 时 与 完成 后 都 可 见 

只 有 下 载 完成 后 可 见 


DownloadManager.Request 类 的 通知 可 见 类 型 
VISIBILITY_HIDDEN 

VISIBILITY VISIBLE 

VISIBILITY VISIBLE NOTIFY. COMPLETED 
VISIBILITY VISIBLE NOTIFY ONLY COMPLETION 





2. 进行 下 载 操作 

构建 完 下 载 请 求 才能 进行 下 载 的 相关 操作 。 下 面 是 DownloadManager 的 常用 方法 。 
enqueue: 将 下 载 请 求 加 入 任务 队列 中 ， 排 队 等 待 下 载 。 该 方法 返回 本 次 下 载 任务 的 编号 。 
remove: 取消 指定 编号 的 下 载 任务 。 

restartDownload: 重新 开始 指定 编号 的 下 载 任务 。 

openDownloadedFile: 打开 下 载 完成 的 文件 。 

getMimeTypeForDownloadedFile: 获取 下 载 完成 文件 的 媒体 类 型 。 

query: 根据 查询 请 求 获取 符合 条 件 的 结果 集 游标 。 


3. 查询 下 载 进度 


虽然 下 载 进度 可 在 通知 栏 上 查看 ， 但 是 如 果 App 自身 也 想 了 解 当 前 的 下 载 进度 ， 就 要 调 
用 下 载 管理 器 的 query 方法 。 该 方法 的 输入 参数 是 一 个 Query 对 象 , 返回 结果 集 的 Cursor 游标 ， 
这 里 的 Cursor 用 法 与 SQLite 里 的 Cursor 一 样 ， 具 体 可 参考 第 4 章 的 “4.2 数据 库 SQLite”。 
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下 面 是 Query 类 的 常用 方法 说 明 。 


setFilterByld: 根据 编号 过 滤 下 载 任务 。 

setFilterByStatus: 根据 状态 过 滤 下 载 任务 。 

setOnlyIncludeVisibleInDownloadsUi: 是 否 只 包含 在 系统 下 载 页 面 上 的 可 见 任务 。 
orderBy: 结果 集 按照 指定 字段 排序 。 


设置 完 查 询 请 求 ， 即 可 调用 DownloadManager 对 象 的 query 方法 ， 获 得 结果 集 的 游标 对 
象 。 该 游标 中 包含 下 载 任务 的 完整 字段 信息 ， 主 要 下 载 字 段 的 取 值 说 明 见 表 10-7。 


表 10-7 下载 字 段 的 取 值 说 明 


DownloadManager 类 的 下 载 字段 


说 明 





COLUMN LOCAL FILENAME 


下 载 文件 的 本 地 保存 路 径 





COLUMN_MEDIA_TYPE 


下 载 文件 的 媒体 类 型 





COLUMN TOTAL SIZE BYTES 
COLUMN BYTES DOWNLOADED SO FAR 
COLUMN STATUS 





下 载 文件 的 总 大 小 
已 下 载 的 文件 大 小 
下 载 状态 。 下 载 状态 的 取 值 说 明 见 表 10-8 


表 10-8 下载 状态 的 取 值 说 明 








DownloadManager 类 的 下 载 状态 说 明 

STATUS PENDING 挂 起 ， 即 正在 等 待 
STATUS_RUNNING 运行 中 
STATUS_PAUSED 暂停 
STATUS_SUCCESSFUL 成 功 
STATUS_FAILED 失败 





另外 ， 系 统 的 下 载 服务 还 提供 3 种 下 载 事 件 ， 开 发 者 可 通过 监听 对 应 的 广播 消息 进行 相 


应 的 处 理 。3 种 下 载 事 件 说 明 如 下 : 
1. 下 载 完成 事件 


在 下 载 完 成 时 ， 系 统 会 发 出 名 为 DownloadManager.ACTION_DOWNLOAD_ COMPLETE 
( 值 为 字符 串 android.intent.action.DOWNLOAD_COMPLETE) 的 广播 ， 因 此 可 注册 一 个 该 广 
播 的 接收 器 ， 用 来 判断 当前 任务 是 否 已 下 载 完毕 ， 并 进行 后 续 的 业务 处 理 。 


2. 下 载 进行 时 的 通知 栏 点 击 事件 


在 下 载 过 程 中 ， 只 要 用 户 点 击 通 知 栏 上 的 下 载 任务 ， 系 统 就 会 发 出 行为 名 称 是 
DownloadManager.ACTION NOTIFICATION CLICKED ( 值 为 字符 串 android.intent.action. 
DOWNLOAD NOTIFICATION CLICKEDO 的 广播 ， 可 注册 该 广播 的 接收 器 进行 相关 处 理 ， 


比如 跳 转 到 该 任务 的 下 载 进度 页 面 等 。 
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3. 下 载 完成 后 的 通知 栏 点 击 事件 


在 不 同时 刻 点 击 通知 栏 上 的 下 载 任务 会 触发 不 同 的 事件 。 下 载 未 完成 时 点 击 触发 的 是 系 
统 广 播 DownloadManager.ACTION_NOTIFICATION_CLICKED。 下 载 完成 后 点 击 触发 的 是 系 
统 的 Intent.ACTION_VIEW (浏览 行为 ) 。 对 于 浏览 行为 ， 系 统 会 根据 媒体 类 型 自动 寻找 对 应 
App 打开 。 因 此 ， 如 果 开 发 者 要 控制 此 时 的 点 击 行为 ， 可 以 调用 Request 对 象 的 setMimeType 
方法 设置 媒体 类 型 ， 这 样 Android 就 会 按照 这 个 类 型 打开 相应 的 App。 

下 面 是 利用 DownloadManager 下 载 APK 安装 包 的 代码 片段 ， 下 载 进度 显示 在 通知 栏 上 : 


private class ApkUrlSelectedListener implements OnltemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) í 
sp apk url.setEnabled(false); 
Uri uri = Uri parse(apkUrlArray[arg? ]); 
Request down = new Request(uri); 
down.setTitle(apkDescArray[arg2]+" 下 载 信息 "); 
down.setDescription(apkDescArray[arg2]+" 安 装 包 正在 下 载 "); 
down.setAllowedNetworkTypes(Request NETWORK MOBILE | Request. NETWORK_WIFI); 
down.setNotificationVisibility(Request. VISIBILITY VISIBLE NOTIFY COMPLETED); 
down.setVisibleInDownloadsUi(true); 
down.setDestinationInExternalFilesDir(DownloadApkActivity.this, 
Environment.DIRECTORY DOWNLOADS, arg2 + ".apk"); 

mDownloadId = mDownloadManager.enqueue(down); 


public void onNothingSelected(AdapterView-?- arg0) í 
J 
; 


/ 接收 下 载 完 成 事件 
public static class DownloadCompleteReceiver extends BroadcastReceiver ( 
@Override 
public void onReceive(Context context, Intent intent) { 
if (intent.getAction().equals(DownloadManager.ACTION DOWNLOAD COMPLETE) 
&&tv apk result != null) í 
long downld = intent getLongExtra(DownloadManager EXTRA DOWNLOAD ID, -1); 
Log.d(TAG, " download complete! id : "+ downld + ", mDownloadId-" + 
mDownloadld); 
tv apk result.setVisibility(View. VISIBLE); 
tv apk result.setText(DateUtil.getNowDateTime(null) + ”编号 " 
+ downld + "的 下 载 任务 已 完成 "); 
sp apk url.setEnabled(true); 
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// 接收 下 载 通知 栏 的 点 击 事件 ， 在 下 载 过 程 中 有 效 ， 下 载 完 成 后 失效 
public static class NotificationClickReceiver extends BroadcastReceiver { 
@Override 
public void onReceive(Context context, Intent intent) { 
Log.d(TAG, " NotificationClickReceiver onReceive"); 
if (intent.getAction().equals(DownloadManager.ACTION NOTIFICATION CLICKED) 
&& tv_apk result != null) í 
long[] downlds = intent.getLongArrayExtra(DownloadManager.EXTRA _ 
NOTIFICATION CLICK DOWNLOAD IDS); 
for (long downld : downlds) í 
Log.d( TAG, " notify click! id : " + downld + ", mDownloadld-" + mDownloadld); 
if (downld == mDownloadld) í 
tv apk result.setText(DateUtil.getNowDateTime(null) + "编号 " 
+ downld + "的 下 载 进度 条 被 点 击 了 一 下 7); 


上 述 代码 接收 并 处 理 了 两 种 下 载 事 件 ， 所 以 要 在 AndroidManifestxml 中 注册 对 应 类 的 广 
播 信息 ， 有 具体 注册 代码 如 下 : 
<receiver android:name-".DownloadApkActivity$DownloadCompleteReceiver" > 
<intent-filter> 
«action android:name="android.intent.action.DOWNLOAD COMPLETE" /> 


</intent-filter> 


</receiver> 


<receiver android:name=".DownloadApkActivity$NotificationClickReceiver" > 
<intent-filter> 
«action android:name-"android.intent.action.DOWNLOAD NOTIFICATION_CLICKED"/> 
</intent-filter> 


</receiver> 


APK 下 载 的 通知 栏 效果 如 图 10-20 和 图 10-21 所 示 。 其中， 图 10-20 所 示 为 下 载 进行 中 的 
通知 栏 界面 ， 图 10-21 所 示 为 下 载 完 成 后 的 通知 栏 界 面 。 


爱 奇 艺 下 载 信息 


+ 





图 10-20 下 载 进行 中 的 通知 栏 图 10-21 下 载 完 成 后 的 通知 栏 
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不 想 在 通知 栏 展 示 下 载 进度 ， 而 是 由 App 自身 在 页 面 上 显示 进度 也 是 可 行 的 。 下 面 是 在 
页 面 上 展示 下 载 进度 的 代码 片段 : 


private Handler mHandler = new Handler(); 
private Runnable mRefresh = new Runnable() { 
@Override 
public void run() { 
boolean bFinish = false; 
Query down_query = new Query(); 
down query.setFilterById(mDownloadld); 
Cursor cursor - mDownloadManager.query(down query); 
if (cursor.moveToFirst()) í 
for (;; cursor.moveToNext()) í 
int nameldx = cursor.getColumnIndex(DownloadManager. COLUMN LOCAL ` 
FILENAME); 
int mediaTypeldx = cursor.getColumnIndex(DownloadManager. COLUMN _ 
MEDIA TYPE); 
int totalSizeldx = cursor.getColumnIndex(DownloadManager. COLUMN _ 
TOTAL SIZE BYTES); 
int nowSizeldx = cursor.getColumnIndex(DownloadManager. COLUMN _ 
BYTES DOWNLOADED SO FAR); 
int statusIdx = cursor.getColumnindex( DownloadManager. COLUMN STATUS); 
int progress = (int) (100 * cursor.getLong(nowSizeldx) / cursor.getLong(totalSizeldx))); 
if (cursor.getString(nameldx) == null) í 
break; 
j 
tpc progress.setProgress(progress, 100); 
mlmagePath = cursor.getString(nameldx); 
String desc = ""; 
desc = String.format("%s 文件 路 径 : %s\n", desc, cursor.getString(nameldx)); 
desc = String.format("%s 媒体 类 型 ; %s\n", desc, cursor.getString(mediaTypeldx)); 
desc = String.format("%s 文件 总 大 小 : 96d", desc, cursor.getLong(totalSizeldx)); 
desc = String.format("%s 已 下 载 大 小 : %d\n", desc, cursor.getLong(nowSizeldx)); 
desc = String.format("%s 下 载 进度 : %d%%\n", desc, progress); 
desc = String.format("%s 下 载 状态 : %s\n", desc, mStatusMap.get(cursor. 
getInt(statusIdx))); 
tv image result.setText(desc); 
if (progress == 100) í 
bFinish = true; 
j 
if (cursor.isLast() == true) f 
break; 








Android Studio TF 325: 从 零 基础 到 App 上 线 





; 

J 

cursor.close(); 

if (bFinish != true) í 
mHandler.postDelayed(this, 100); 

1 else í 
sp_image_url.setEnabled(true); 
tpc_progress.setVisibility( View.INVISIBLE); 
iv_image_url.setImageURI(Uri.parse(mImagePath)); 


In 
上 述 代 码 不 在 通知 栏 显示 下 载 进度 ， 即 将 通知 可 见 类 型 设置 为 VISIBILITY_HIDDEN, 此 
时 需要 在 AndroidManifest.xml 中 加 入 对 应 权限 ， 有 具体 的 权限 配置 如 下 : 
<!-- 下 载 时 不 提示 通知 栏 -> 
<uses-permission android:name="android.permission.DOWNLOAD WITHOUT NOTIFICATION" /> 
在 页 面 上 动态 展示 图 片 下 载 进度 的 效果 如 图 10-22 和 图 10-23 所 示 。 进 度 形式 采用 10.1 
节 介 绍 的 文字 进度 圈 , 在 下 载 过 程 中 显示 带 百分比 文字 的 进度 圆圈 ， 下 载 完 成 后 显示 已 下 载 的 
图 片 。 其中， 图 10-22 所 示 为 刚 开始 下 载 、 进 度 是 4% 时 的 下 载 页 面 ， 此 时 采用 进度 圆圈 占 位 ; 图 
10-23 所 示 为 下 载 完 毕 的 页 面 ， 此 时 占 位 用 的 进度 圆圈 消失 ， 取 而 代 之 的 是 下 载 到 本 地 的 图 片 。 


network 





| 请 选择 要 下 载 的 图 片 LII 


4€. | 














10-22 ” 刚 开始 下 载 图 片 时 的 进度 圈 10-23 图 片 下 载 完 成 的 界面 
10.3.2 文件 对 话 框 
下 载 和 上 传 操作 涉及 文件 的 保存 和 打开 ， 就 像 电脑 上 的 文件 对 话 框 ， 既 可 选择 文件 又 可 
保存 文件 。 然 而 Android 没有 提供 现成 的 文件 对 话 框 控件 ， 我 们 要 自己 实现 文件 对 话 框 。 有 关 
对 话 框 的 自 定义 代码 可 参见 第 6 章 的 “6.3 自 定义 对 话 框 ”， 文 件 对 话 框 的 实现 走 的 是 另 一 条 
路 ， 即 利用 DialogFragment 自 定义 对 话 框 。 
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还 记得 第 5 章 的 “5.3 碎片 Fragment” 吧 ，DialogFragment 其 实 是 碎片 Fragment 的 一 个 子 
生命 周期 和 具体 用 法 可 参照 Fragment。 当 然 ，Fragment 并 非 仅 有 DialogFragment 一 个 子 
， 还 有 其 他 几 个 子 类 ， 分 别 用 在 某 些 特殊 场合 。 下 面 进行 简要 说 明 。 


e DialogFragment: 用 于 对 话 框 的 碎片 。 对 话 框 的 页 面 构建 要 写 在 onCreateDialog 方法 中 。 

e ListFragment: 用 于 列表 的 碎片 ， 目 的 是 取代 ListActivity。 

e PreferenceFragment: 用 于 参数 设置 页 面 的 碎片 ， 目 的 是 取代 PreferenceActivity。 比 如 

Android 自 带 的 “系统 设置 ”应 用 使 用 了 PreferenceFragment。 

e WebViewFragment: 用 于 网 页 视图 的 碎片 。 

由 于 文件 对 话 框 的 具体 实现 代码 较 长 ， 因 此 不 贴 在 书 上 了 ， 有 兴趣 的 读者 可 自行 查看 本 
书 下 载 资源 中 的 相关 源码 。 

文件 对 话 框 的 展示 效果 如 图 10-24 和 图 10-25 所 示 。 其 中 ， 图 10-24 所 示 为 保存 文件 的 对 
话 框 截图 ， 图 10-25 所 示 为 打开 文件 的 对 话 框 截图 。 





LI. 


cip 打开 文件 
b d < 

bos 

Mini 0000 png 
l RecordAudio 

ER png 
l RecordVideo 

o: png 





o: png 
有 oo png 
LH TI 





图 10-24 文件 保存 对 话 框 图 10-24 文件 打开 对 话 框 
考虑 到 文件 对 话 框 是 一 个 通用 控件 ， 并 且 拥 有 统一 风格 的 图 标 、 文 字 与 尺寸 ， 建 议 为 其 
单独 建 一 个 名 为 filedialog 的 新 模块 。 其 他 模块 若 有 用 到 文件 对 话 框 ， 则 可 直接 导入 filedialog， 
无 须 手 工 复制 代码 与 各 类 资源 。 导 入 filedialog 的 办 法 是 ， 打 开 其 他 模块 的 编译 配置 文件 
build.gradle, fE dependencies 依赖 块 中 增加 如 下 配置 ， 表 示 导 入 filedialog: 
compile project(':filedialog') 


10.333 文件 上 传 


与 文件 下 载 相 比 ， 文 件 上 传 的 场合 不 是 很 多 ， 通 常用 于 上 传 用 户头 像 、 朋 友 圈 发 布 图 片 
和 视频 动态 等 , 而且 上 传 文件 需要 后 端 服 务 器 配合 ， 容 易 被 开发 者 忽略 。 网 络 通信 少不了 文件 
上 传 ， 特 别 是 对 于 社交 类 App《〈 如 微 信 、QQ、 微 博 等 ) 来 说 ， 上 传 文件 是 必 不 可 少 的 功能 ， 
因此 有 必要 掌握 文件 上 传 的 相关 技术 。 
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很 可 惜 , Android 提供 了 下 载 管理 器 DownloadManager, 却 没有 提供 专门 的 文件 上 传 工具 ， 
开发 者 得 自己 写 代码 实现 上 传 功 能 。 简单 实现 文件 上 传 其 实 也 不 难 , 一 样 是 按照 HTTP 访问 的 
POST 流程 ， 只 是 要 采取 multipart/form-data 的 方式 分 段 传 输 ， 并 加 入 分 段 传输 的 边界 字符 串 。 

下 面 是 通过 HttpURLConnection 上 传 文件 的 代码 : 


public class HttpUploadUtil í 
public static String upload(String uploadUrl, String uploadFile) í 

String fileName = ""; 

int pos — uploadFile.lastIndexOf("/"); 

if (pos >= 0) í 
fileName = uploadFile.substring(pos + 1); 

; 

String end = rn"; 

String Hyphens = "--": 

String boundary = "WUm4580jbtwfJhNp7zi IdjFEO3wNNm"; 

try ( 
URL url = new URL(uploadUrl); 
HttpURLConnection conn = (HttpURLConnection) url.openConnection(); 
conn.setDolInput(true); 
conn.setDoOutput(true); 
conn.setUseCaches(false); 
conn.setRequestMethod(" POST"); 
conn.setRequestProperty("Connection", "Keep-Alive"); 
conn.setRequestProperty("Charset", "UTF-8"); 
conn.setRequestProperty("Content-Type", "multipart/form-data;boundary-" + boundary); 


DataOutputStream ds — new DataOutputStream(conn.getOutputStream()); 
ds.writeBytes(Hyphens + boundary + end); 
ds.writeBytes("Content-Disposition: form-data; " 
+ "name=\"filel\";filename=\"" + fileName + "\"" + end); 

ds.writeBytes(end); 
FileInputStream fStream = new FileInputStream(uploadFile); 
// 每 次 写 入 1024 F 
int bufferSize = 1024; 
byte[] buffer = new byte[bufferSize]: 
int length = -1; 
// 将 文件 数据 写 入 缓冲 区 
while((length = fStream.read(buffer)) != -1) í 

ds.write(buffer, 0, length); 
} 
ds.writeBytes(end); 
ds.writeBytes(Hyphens + boundary + Hyphens + end); 
fStream.close(); 
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ds.flush(); 

// 获取 返回 内 容 

InputStream is = conn.getlnputStream(); 

int ch; 

StringBuffer b = new StringBuffer(); 

while ((ch = is.read()) != -1) í 
b.append((char) ch); 

; 


ds.close(); 
return "SUCC"; 


} catch (Exception e) í 
e.printStackTrace(); 
return "上 传 失败 :" + e.getMessage(); 


j 
然后 通过 异步 任务 AsyncTask 调用 文件 上 传 功能 ， 文 件 上 传 任务 的 代码 如 下 : 


public class UploadHttpTask extends AsyncTask<String, Void, String> í 
private final static String TAG = "UploadHttpTask"; 
private Context mContext; 


public UploadHttpTask(Context context) í 
super(); 
mContext = context; 


@Override 

protected String dolnBackground(String... params) í 
String uploadUrl = params[0]; 
String filePath = params[1]; 
Log.d(TAG, "uploadUrl-" + uploadUrl + ", filePath-" + filePath); 
String result = HttpUploadUtil.upload(uploadUrl, filePath); 
return result; 


@Override 
protected void onPostExecute(String result) { 
mListener.onUploadFinish(result); 


private OnUploadHttpListener mListener; 
public void setOnUploadHttpListener( OnUploadHttpListener listener) í 
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的 


mListener = listener; 


" 
f 


public static interface OnUploadHttpListener í 


public abstract void onUploadFinish(String result); 


h 
ji 


Xf Efe 





上 传 服务 器 。 若 


ED 在 笔记 本 








具 界 面 上 设置 WIFI 











t 





需要 服务 器 配合 ， 即 服务 器 要 开启 HTTP 的 上 传 服 务 ， 这 涉及 服务 端 开发 。 正 
所 谓 一 入 IT 深 似 海 , 55 


客户 端 还 得 会 服务 端 , 赶紧 找 个 做 PEE 的 同学 帮忙 ,搭建 一 下 HTTP 





名 称 、 


-时 半 刻 找 不 到 帮手 也 没关系 ， 只 要 读者 的 笔记 本 电脑 自 带 无 线 网 卡 ， 就 能 
自己 动手 、 丰 衣 足 食 。 上 传 服务 器 的 具体 搭建 步骤 如 下 : 


电脑 上 下 载 并 安装 “360 免费 WiFi" 软件 ,运行 该 工具 给 电脑 开启 WIFI 热点， 

















户 名 、 密 码 等 








CXJ02 关闭 Windows 系统 服务 的 防火 墙 。 无 论 是 系统 自 带 的 Windows Firewall， 还 是 其 他 杀毒 
的 防火 墙 ， 统 统 关 掉 ， W 








手机 连 不 上 电脑 的 WIFI。 








EI 打开 手机 的 WLAN 功能 ， 连 接 电脑 刚 开 的 WIFI， 要 求 手 机 能 够 上 网 才 算 连 接 成 功 。 


CET 在 笔记 本 





电脑 上 于 





开 Eclipse， 导 入 本 书 附带 的 文件 上 传 服 务 端 demo 一 一 UploadTest T 


程 ， 右 击 该 工程 并 依次 选择 Run As 一 Run on Server， 启 动 该 工程 。 
E 在 命令 窗口 运行 ipconfig /all， 在 结果 中 找到 Microsoft Virtual WiFi Miniport Adapter, £T 


框 部 分 为 了 


fis 








在 笔记 本 电脑 上 搭建 好 模拟 的 HTTP 上 传 服务 
工程 中 的 上 传 地 址 (如 
http://192.168.253.1:8080/UploadTest/uploadServlet) , 


再 修改 App 


F 机 观察 到 的 电脑 IP (如 图 10-26 所 示 )， 也 就 是 App 认可 的 服务 器 IP. 


[EI] 


图 10-26 在 命令 行 下 面 找 到 的 电脑 WIFI 的 IP hihi: 


http://192.168.0.212:8080/UploadTest/uploadServlet 


然后 把 App 安装 到 手机 上 , 就 可 以 在 手机 上 测试 文件 HTTP 上 传 文件 
上 传 功能 了 。 上 传 文件 的 路 径 为 : /storage/emulated/0/ 


Download/10000.png 


文件 上 传 的 效果 如 图 10-27 所 示 。 倘 车 上 传 成 功 ， | 上 传 结果 为 : succ 


预计 下 载 地 址 为 : http://192.168.0.212:8080/ 


还 应 给 出 服务 器 对 应 的 文件 下 载 地 址 ， 这 样 才 好 验证 ^ [uptoadTesu10000.png 
上 传 成 功 与 和 否 。 





图 10-27 文件 上 传 成 功 的 效果 图 
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10.4” 套 接 字 Socket 


本 节 介 绍 套 接 字 Socket 的 技术 手段 与 具体 用 途 ， 首 先 说 明 如 何 使 用 网 络 地 址 工具 
InetAddress 判断 某 个 网 络 地 址 的 连通 性 ， 然 后 痔 述 Socket 技术 在 计算 机 网 络 中 所 处 的 层次 、 
应 用 方向 以 及 基本 用 法 。 


10.4.1 网络 地 址 InetAddress 


有 些 时 候 , 手机 明明 可 以 上 网 ,App 也 加 了 网 络 访问 权限 , 可 是 HTTP 请 求 某 个 地 址 却 总 
是 连 不 上 。 仙 到 这 种 情况 ,很 可 能 是 把 对 方 的 地 址 弄 错 了 ， 导 致 尝试 连接 一 个 根本 连 不 了 的 地 
址 。 所 以 有 必要 在 发 起 请 求 前 检查 一 下 能 和 否 与 对 方 地 址 建立 连接 。 

检查 设备 自身 与 某 个 网 络 地 址 的 连通 性 用 到 了 InetAddress 工具 ， 这 是 对 网 络 地 址 的 一 个 
封装 。 下 面 介绍 该 工具 的 主要 方法 说 明 。 
getByName: 根据 主机 IP 或 主机 名 称 获取 InetAddress 对 象 。 
getHostAddress: 获取 主机 的 IP 地 址 。 
getHostName: 获取 主机 的 名 称 。 
isReachable: 判断 该 地 址 是 否 可 到 达 ， 即 是 否 连通 。 
下 面 是 检查 网 络 地 址 能 否 连 通 的 代码 片段 : 

public void onClick(View v) í 


if (v.getld() == R.id.btn host name) í 
new CheckThread(et host name.getText().toString()).start(); 


j 
b 


private Handler mHandler = new Handler() í 
@Override 
public void handleMessage(Message msg) { 
tv_host_name.setText(" 主 机 检查 结果 如 下 : \n"+msg.obj); 
h 


private class CheckThread extends Thread ( 
private String mHostName; 
public CheckThread(String host name) í 
mHostName = host name; 
; 


(aOverride 
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public void run() í 
Message message = Message.obtain(); 
tyi 
InetAddress host = InetAddress.getByName(mHostName); 
boolean isReachable = host.isReachable(5000); 
String desc = (isReachable)?" 可 以 连接 ":" 无 法 连接 "; 
if (isReachable == true) í 
desc = String.format("%s\n 主机 名 为 %s 主机 地 址 为 %s"， 
desc, host.getHostName(), host.getHostAddress()); 
; 
message.what — 0; 
message.obj — desc; 
} catch (Exception e) í 
e.printStackTrace(); 
message.what — -1; 
message.obj — e.getMessage(); 
j 
mHandler.sendMessage(message); 


j 


检查 网 络 地 址 连通 性 的 效果 如 图 10-28 和 图 10-29 所 示 。 其 中 ， 图 10-28 是 根据 网 站 域名 
检测 连通 性 ， 图 10-29 是 根据 IP 地 址 检测 连通 性 。 











www.163.com | 

















检查 主机 名 
主机 检查 结果 如 下 : 
可 以 连接 
主机 名 为 www.163.com 1 
主机 地 址 为 183.250.179.133 主机 地 址 为 192.168.253.1 
图 10-28 检测 域名 的 连通 性 结果 图 图 10-29 检测 IP 的 连通 性 结果 图 


10.4.2 Socket 通信 


对 于 程序 开发 来 说 , 网 络 通信 的 基础 就 是 Socket, 不 过 正 因为 是 基础 , 所 以 用 起 来 不 容易 。 
计算 机 网 络 有 一 个 大 名 易 易 的 TCP/IP 协议 , 普通 用 户 在 电脑 上 设置 本 地 连接 的 IP 时 经 常 看 到 
图 10-30 所 示 的 弹 窗 ， 注 意 红 框 部 分 已 经 很 好 地 描述 了 TCP/IP 协议 的 作用 。 

TCP/IP 是 一 个 协议 组 ， 分 为 3 个 层次 : 网 络 层 、 传 输 层 和 应 用 层 。 


e 网 络 层 : 包括 IP 协议 、ICMP 协议 、ARP 协议 、RARP 协议 和 BOOTP 协议 。 
e 传输 层 : 包括 TCP 协议 和 UDP 协议 。 
e 应 用 层 : 包括 HTTP. FTP. TELNET. SMTP. DNS 等 协议 。 
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本 章 之 前 提 到 的 网 络 通信 编程 其 实 都 是 应 用 层 的 


8 本 地 连接 属性 一 一 








HTTP 编程 。Socket 属于 传输 层 的 技术 ， API 实现 TCP |P Es] 


协议 后 即 可 用 于 HTTP 通信 ， 实 现 UDP 协议 后 即 可 用 | 二 BR 
于 FTP 通信 ， 当 然 也 可 以 直接 在 底层 进行 点 对 点 通信 ， 
比如 即时 通信 软件 (QQ、 微 信 ) 就 是 这 样 。 除 了 即时 | RT 中 


: 9 、 F] r SuigEni HH 
通信 ，Socket 技术 也 常常 用 于 在 线 咨询 、 消 息 推送 等 需 A uras BIKE 2 Qoid) 
要 实时 交互 消息 的 场合 。 ga 1 


Android 的 Socket 编程 主要 使 用 Socket 和 iniciando ， 
ServerSocket 两 个 类 ， 下 面 分 别 进行 介绍 。 


1 


Socket 是 最 常用 的 工具 ， 客 户 端 和 服务 端 都 要 用 
(we J| má J 

到 ， 描 述 了 两 边 对 套 接 字 (Socke 处 理 的 一 般 行为 。 € 

下 面 介 绍 Socket 的 主要 方法 。 


. Socket 








于 Realtek PCIe GBE Family Controller 








RAC)... 












Internet Hù 
层 括 扑 发 现 映 射 器 1/0 驱动 程序 I 











TI Bit do 














图 10-30 电脑 上 的 本 地 连接 配置 页 面 


connect: 连接 指定 IP 和 端口 。 该 方法 用 于 客户 端 连接 服务 端 。 
getInputStream: 获取 输入 流 ， 即 自身 收 到 对 方 发 过 来 的 数据 。 
getOutputStream: 获取 输入 流 ， 即 自身 向 对 方 发 送 的 数据 。 
getInetAddress: 获取 网 络 地 址 对 象 。 该 对 象 是 一 个 InetAddress 实例 。 
isConnected: 判断 socket 是 否 连 上 。 

isClosed: 判断 socket 是 否 关闭 。 

close: 关闭 socket, 


2. ServerSocket 


ServerSocket 仅 用 于 服务 端 ， 在 运行 时 不 停 地 侦 听 指定 端口 。 下 面 介绍 ServerSocket [1] 3: 


要 方法 。 


构造 函数 : 指定 侦 听 哪个 端口 。 

accept: 开始 接收 客户 端的 连接 。 有 客户 端 连 上 时 就 返回 一 个 Socket 对 象 ， 若 要 持续 侦 
听 连 接 ， 则 在 循环 语句 中 调用 该 函数 。 

getInetAddress: 获取 网 络 地 址 对 象 。 该 对 象 是 一 个 InetAddress 实例 。 

isClosed: 判断 socket 服务 器 是 否 关 闭 。 

close: 关闭 socket 服务 器 。 


下 面 通过 具体 代码 演示 Socket 通信 的 案例 , 首先 在 客户 端 与 服务 端 之 间 建 立 Socket 连接 ， 
详细 代码 如 下 : 


public class MessageTransmit implements Runnable { 


private static final String TAG = "MessageTransmit"; 


private static final String SOCKET IP = "192.168.1.5"; // Socket 服务 器 的 下， 根据 实际 情况 修改 


private static final int SOCKET PORT —51000; //Socket 服务 器 的 端口 ， 根 据 实际 情况 修改 
private Socket mSocket; 


ESTE 
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private BufferedReader mReader = null; 
private OutputStream m Writer = null; 


@Override 
public void run() í 
mSocket = new Socket(); 
try { 
mSocket.connect(new InetSocketAddress(SOCKET IP, SOCKET_PORT), 3000); 
mReader = new BufferedReader(new InputStreamReader(mSocket.getInputStream())); 
mWriter = mSocket.getOutputStream(); 
new RecvThread().start(); // 启动 一 条 子 线程 读 取 服务 器 的 返回 数据 
Looper.prepare(); 
Looper.loop(); 
} catch (Exception e) í 
e.printStackTrace(); 
J 
j 


/ 定义 接收 UI 线程 的 Handler X158, App 向 后 台 服 务 器 发 送 消息 
public Handler mRecvHandler = new Handler() í 
@Override 
public void handleMessage(Message msg) { 
Log.d(TAG, "handleMessage: "+msg.obj); 
String send msg = msg.obj.toString() n"; 
U 换行 符 相 当 于 回 车 键 ， 表 示 “ 我 写 好 了 发 出 去 吧 ” 
try ( 
mWruiter.write(send msg.getBytes("utf8")); 
) catch (Exception e) í 
e.printStackTrace(); 


k 
/ 定义 消息 接收 子 线程 ，App 从 后 全 服务 器 接收 消息 
private class RecvThread extends Thread { 
(@Override 
public void run() í 
uy i 
String content = null; 
while (content = mReader.readLine()) != null) (— // 读 取 来 自 服务 器 的 数据 
Message msg = Message.obtain(); 
msg.obj = content; 
SocketActivity.mHandler.sendMessage(msg); 
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} catch (Exception e) { 
e.printStackTrace(); 


} 
然后 在 Activity 中 启动 Socket 连接 的 线程 ， 等 待 界面 向 Socket 服务 器 发 送 消息 ， 并 准备 
接收 消息 ， 完 整 的 页 面 代码 如 下 : 


public class SocketActivity extends AppCompatActivity implements OnClickListener { 
private EditText et_socket; 
private static TextView tv socket; 
private MessageTransmit mTransmit; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
Super.onCreate(savedInstanceState); 
setContentView(R.layout.activity socket); 
et socket — (EditText) findViewById(R.id.et socket); 
tv socket = (TextView) findViewById(R.id.tv socket); 
findViewById(R.id.btn socket).setOnClickListener(this); 
mTransmit = new MessageTransmit(); 
new Thread(mTransmit).start(); 


} 


@Override 
public void onClick(View v) { 
if (v.getId() = R.id.btn socket) í 
Message msg = Message.obtain(); 
msg.obj = et socket.getText().toString(); 
/ 注意 这 里 是 主线 程 向 分 线程 发 送 消息 ， 与 IntentService 的 情况 类 似 
mTransmit.mRecvHandler.sendMessage(msg); 


; 
j 
public static Handler mHandler = new Handler() í 
@Override 
public void handleMessage(Message msg) { 
String desc = String.format("%s 收 到 服务 器 的 应 答 消息 : "os", 
DateUtil.getNowTime(), msg.obj.toString()); 
tv socket.setText(desc); 
} 
h 
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最 后 启动 Socket 服务 器 〈 其 实 一 开始 就 要 启动 ， 这 样 App 运行 时 才能 马上 连 上 后 端 服务 
器 ) Socket 服务 端的 源码 见 本 书 下 载 资 源 Socket 工程 的 TestServer.java， 服务器 搭建 过 程 参 
见 10.3 节 的 “10.3.3 文件 上 传 ”末尾 部 分 。 

Socket 通信 的 效果 如 图 10-31 和 图 10-32 所 示 。 其 中 ， 图 10-31 所 示 为 准备 发 送 消息 时 的 
界面 , 图 10-32 所 示 为 点 击发 送 按钮 后 的 界面 ,此 时 App 向 Socket 服务 器 发 送 消息 内 容 “hello， 
你 好 蚜 ”，Socket 服务 器 立即 回复 “hi, 很 高 兴 认 识 你 ”, 回复 内 容 已 即时 显示 在 App HHE. 


network network 





hello ,你 好 呀 hello， 你 好 呀 


发 送 消息 
17:33:21 收 到 服务 器 的 应 答 消息 ; hi， 很 高 兴 认识 你 





图 10-31 Socket 消息 发 送 前 的 界面 图 10-32 Socket 消息 发 送 后 的 界面 


10.5 KRMH: 仿 手机 QQ 的 聊天 功能 


说 到 使 用 最 广泛 的 App， 那 无 疑 是 以 手机 QQ、 微 信 为 代表 的 即时 通信 或 社交 类 App， 类 
似 的 App 还 有 陌 陌 、 旺 旺 等 。 这 些 社交 App 基本 都 是 主打 聊天 功能 ， 聊 天 的 内 容 包括 文本 消 
息 、 图 片 消息 、 语 音 消息 、 视 频 消息 等 ， 其 展现 内 容 之 丰富 、 通 信 手 段 之 多 样 实 为 App 界 的 
翘楚 。 本 章 以 “ 仿 手机 QQ 的 聊天 功能 ”作为 实战 项 目 ， 通 过 剖析 即时 通信 的 相关 技术 使 得 读 
者 进一步 加 深 对 网 络 通 信 开 发 的 理解 。 


10.5.1 设计 思 


手机 QQ 的 聊天 界面 大 家 再 熟悉 不 过 了 。 不 过 作为 App 开发 者 的 你 ， 是 否 能 够 自己 “ 山 
K” 一 个 聊天 App? 听 起 来 很 高 深 的 样子 ， 自 己 只 是 一 个 初学 者 啊 。 有 道 是 世上 无 难事 ， 只 怕 
有 心 人 , 谁 说 初学 者 就 做 不 到 ? 下 面 跟 着 笔者 一 步 一 步 往 下 走 , 慢 慢 抽 丝 剥 昔 , 看 看 QQ 内 部 
到 底 藏 着 什么 “葵花 宝典 ”。 

先 来 两 张 手机 QQ 的 界面 截图 。 图 10-33 所 示 为 联系 人 频道 的 好 友 列 表 页 面 ， 图 10-34 所 
示 为 与 好 友 聊 天 的 主页 面 ， 文 本 消息 、 图 片 消 息 、 语 音 消息 都 在 这 里 发 送 与 接收 。 

看 过 了 官方 App 的 界面 ， 再 回来 琢磨 与 本 章 的 网 络 通信 技术 有 什么 关系 。 也 许 读者 初 来 
乍 到 ， 还 不 太 明 白 ， 下 面 给 出 一 个 山寨 后 的 效果 图 ， 让 读者 先 有 一 个 直观 的 认识 。 准 备 山寨 的 
效果 页 面 如 图 10-35 和 图 10-36 所 示 。 其 中 ， 图 10-35 是 山寨 后 的 好 友 列 表 页 面 ， 图 10-36 是 
山寨 后 的 聊天 页 面 。 

现在 看 起 来 ， 功 能 相对 纯粹 了 许多 ， 去 掉 了 无 关 的 技术 部 分 ， 只 保留 与 本 章 知识 点 有 关 
的 内 容 。 
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图 10-33 ”好友 列表 页 面 图 


好 友 列 表 
2 个 好 友 


在 线 好 友 
& BET 2016-11-14 23:47:35] 


&j Xu 2016-11-14 22:59:32] 
亲 威 


图 10-35 山寨 后 的 好 友 列 表 页 面 











10-34 ”聊天 窗口 页 面 


与 大 山 聊天 
AU 2016-11-14 23:02:16 
hi, 好 久 不 见 
238688 2016-11-14 23:51:41 
TA, 是 呢 
AU 2016-11-14 23:03:42 
LL T? 


31 95 2016-11-14 23:54:05 
GGRHANENTERT , RE, 











图 10-36. 山寨 后 的 聊天 窗口 页 面 





下 面 分 析 一 下 效果 图 涉及 的 本 章 的 知识 点 。 控 件 看 得 见 、 摸 得 着 ， 列 举 并 不 困难 ， 而 网 
络 通信 在 后 台 运 行 , 不 是 马上 能 够 想得到 、 说 得 出 的 ， 所 以 不 妨 尽 可 能 地 发 挥 想 像 力 ,无 论 有 
没有 、 能 不 能 实现 ， 先 列举 出 来 再 说 。 笔 者 这 里 归纳 以 下 8 个 重点 。 


e 多 线程 : 网 络 通信 必然 使 用 多 线程 技术 。 


e HTTP 接口 调用 : App 向 服务 器 请 求全 部 好 友 列 表 ， 是 正规 的 HTTP 接口 访问 。 
e° HTTP 获取 图 片 : 好 友 的 最 新 头像 ， 因 为 是 小 图 ， 所 以 适合 通过 HTTP 协议 直接 获取 图 片 。 
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文件 上 传 : 发 送 图 片 消息 、 发 送 语音 消息 时 都 得 把 手机 上 的 图 片 或 声音 文件 上 传 给 服务 器 。 
文件 下 载 : 对 方 接收 图 片 和 语音 消息 ， 很 可 能 从 服务 器 下 载 图 片 和 声音 文件 到 手机 里 。 
文件 对 话 框 : 选择 上 传 的 文件 和 保存 收 到 的 文件 都 会 用 到 文件 对 话 框 。 

文字 进度 圆圈 : 对 方 接收 图 片 或 语音 时 ， 聊 天 窗口 往往 先 显示 占 位 图 标 ， 再 根据 下 载 进 
度 展示 圆 弧 形 式 的 百分比 ， 让 用 户 知晓 消息 发 送 与 接收 的 进展 。 

e Socket 通信 : 这 个 技术 是 重 中 之 重 ， 因 为 所 有 聊天 消息 都 通过 Socket 通信 传送 给 对 方 。 


接 下 来 对 Socket 通信 进行 补充 说 明 ， 因 为 涉及 客户 端 与 服务 端的 交互 ， 所 以 通信 的 流程 
稍微 有 些 复杂 。 


1. 划分 聊天 场景 的 功能 点 

平常 我 们 看 到 的 QQ 聊天 相关 页 面 有 3 个 : 登录 页 面 、 好 友 列 表 页 面 和 聊天 页 面 。 因 此 ， 
对 应 的 Socket 功能 也 分 为 3 类 : 

(1) 登录 与 注销 。 登 录 操 作对 应 建立 Socket 连接 ， 注 销 操 作对 应 断 开 Socket 连接 。 

(2) 获取 在 线 好 友 列 表 。 与 Socket 有 关 的 是 获取 当前 在 线 的 好 友 列 表 ， 客 户 端 到 服务 端 
查询 当前 已 建立 Socket 连接 的 好 友 列 表 。 

G) 发 送 消息 与 接收 消息 。 发 送 与 接收 消息 对 应 的 是 Socket 的 数据 传输 ， 发 送 消息 操作 
是 客户 端 A 向 服务 端 发 送 Socket 数据 , 接收 消息 操作 是 服务 端 将 收 到 的 A 消息 向 客户 端 B 发 
送 Socket 数据 。 


2. 在 App 端 实现 相关 功能 


(1) 至 少 3 个 聊天 相关 页 面 : 登录 页 面 、 好 友 列 表 页 面 和 聊天 页 面 。 

(2) 一 个 用 于 Socket 通信 的 线程 ,由 于 在 App 运行 过 程 中 要 保持 Socket 连接 ,因此 Socket 
线程 要 放 在 自 定义 的 Application 类 中 。 

G) 聊天 页 面向 Socket 线程 发 送 消息 的 机 制 ， 用 于 登录 请 求 、 注 销 请 求 、 获 取 在 线 好 友 
列表 请 求 、 发 送 消息 等 。 

(4) Socket 线程 向 页 面 发 送 消 息 的 机 制 ， 用 于 返回 在 线 好 友 列 表 、 接 收 消息 等 。 因 为 返 
回 消息 会 分 发 到 不 同 的 页 面 ， 所 以 建议 采用 广播 Broadcast 传播 消息 ， 在 好 友 列 表 页 面 和 聊天 
页 面 各 注册 一 个 广播 接收 器 ， 根 据 服务 器 返回 的 数据 刷新 在 线 好 友 列 表 和 聊天 记录 。 
(5) 对 于 图 片 消息 与 声音 消息 的 发 送 。 可 先 把 文件 上 传 到 服务 器 ， 然 后 把 文件 下 载 地 址 
作为 消息 文本 传 给 对 方 ， 对 方 App 收 到 消息 后 ， 根 据 消息 文本 中 的 文件 地 址 把 文件 下 载 到 本 
了 地， 再 在 聊天 页 面 上 展示 出 来 。 


3. 在 服务 端 启动 Socket 服务 器 
启动 Socket 服务 器 后 ， 实 现 以 下 功能 : 


CD 定义 一 个 Socket 连接 的 队列 ， 用 于 保存 当前 连接 的 Socket 请 求 。 

(2) 循环 侦 听 指定 端口 ， 一 旦 有 新 连接 进来 ， 就 将 该 连接 加 入 Socket 队列 ， 并 启动 新 线 
程 为 该 连接 服务 。 

(3) 每 个 服务 线程 持续 从 Socket 中 读 取 客户 端 发 过 来 的 数据 ， 并 对 不 同 请 求 做 相应 的 处 理 。 
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O 如 果 是 登录 请 求 ， 就 标识 该 Socket 连接 的 用 户 昵称 、 设 备 编号 、 登 录 时 间 等 信息 。 
© 如 果 是 注销 请 求 ， 就 断 开 Socket 连接 ， 并 从 Socket 队列 中 移 除 该 连接 。 

@ 如 果 是 获取 在 线 好 友 列 表 请 求 ， 就 遍历 Socket 队列 ， 封 装 好 友 列 表 数据 并 返 
QD 如 果 是 发 送 消息 请 求 , 就 根据 好 友 的 设备 编号 到 Socket 队 列 中 查找 对 应 的 Socket E Be, 


Iz] 





并 向 该 连接 返回 消息 内 容 。 





4. 定义 服务 端 与 客户 端 之 间 传 输 消息 的 格式 
消息 包 分 为 包头 与 包 体 ， 包 头 用 于 标识 操作 类 型 、 操 作对 象 、 操 作 时 间 等 基本 要 素 ， 包 


体 用 于 存放 具体 的 消息 内 容 (如 好 友 列 表 、 消 息 文本 等 ) 。Socket 通信 一 般 不 用 XML 或 JSON 
等 复杂 格式 ， 而 是 直接 用 分 隔 符 划分 包头 、 包 体 以 及 包头 内 部 的 元 素 。 


10.5.2 ”小 知识 可 折 双 列表 视图 ExpandableListView 


可 折 辣 列表 视图 是 一 种 多 功能 的 高 级 控件 ， 每 个 子 项 都 可 以 展开 一 个 孙子 列表 。 点 击 一 


个 分 组 CUB) ， 即 可 展开 该 分 组 下 的 孙子 列表 ; 再 次 点 击 该 分 组 ， 即 可 收 起 该 分 组 下 的 孙子 
列表 。 如 果 LinearLayout 是 一 维 视图 ，ListView 与 GridView 是 二 维 视图 ，ExpandableListView 
就 是 三 维 视图 。 可 折 受 列表 视图 虽然 号 称 高 级 , 但 使 用 的 场合 不 少 ,常见 的 业务 场景 包括 好 友 
分 组 与 好 友 列 表 、 邮 件 夹 分 组 与 邮件 列表 、 订 单列 表 与 订单 内 的 商品 列表 等 。 


下 面 是 可 折合 列表 视图 的 常用 方法 说 明 。 


setAdapter: 设置 适配器 。 适 配器 类 型 为 ExpandableListAdapter。 

expandGroup: 展开 指定 分 组 。 

collapseGroup: 收 起 指定 分 组 。 

isGroupExpanded: 判断 指定 分 组 是 否 展开 。 

setSelectedGroup: 设置 选中 的 分 组 。 

setSelectedChild: 设置 选中 的 孙子 项 。 

setGroupIndicator: 设置 指定 分 组 的 指示 图 像 。 

setChildIndicator: 设置 指定 孙子 项 的 指示 图 像 。 

setOnGroupExpandListener: 设置 分 组 展开 监听 器 。 需 实现 接口 OnGroupExpandListener 

的 onGroupExpand 方法 ， 该 方法 在 点 击 展开 分 组 时 触发 。 

e setOnGroupCollapseListener: 设置 分 组 收 起 监听 器 。 需 实现 接口 OnGroupCollapseListener 
的 onGroupCollapse 方法 ， 该 方法 在 点 击 收 起 分 组 时 人 触发 。 

e setOnGroupClickListener: 设置 分 组 点 击 监听 器 。 需 实现 接口 OnGroupClickListener 的 
onGroupClick 方法 ， 该 方法 在 点 击 分 组 时 触发 。 

e setOnChildClickListener: 设置 孙子 项 点 击 监听 器 。 需 实现 接口 OnChildClickListener 的 

onChildClick 方法 ， 该 方法 在 点 击 孙 子 项 时 触发 。 


可 折 车 列表 视图 拥有 专属 的 适配器 一 一 可 折合 列表 适配器 ExpandableListAdapter。 下 面 是 


e © o @ @ @ @ o o 





该 适配器 经 常 要 重 写 的 5 个 方法 。 





e getGroupCount: 获取 分 组 的 个 数 。 
e getChildrenCount: 获取 孙子 项 的 个 数 。 
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e getGroupView: 获取 指定 分 组 的 视图 。 
e getChildView: 获取 指定 孙子 项 的 视图 。 
e isChildSelectable: 判断 孙子 项 是 否 允许 选择 。 


下 面 演示 如 何 使 用 可 折合 列表 视图 实现 电子 邮箱 的 管理 功能 。 首 先 编写 邮箱 列表 的 适 配 
器 ， 详 细 代 码 如 下 (为 节省 篇 幅 ， 省 略 了 没有 实际 内 容 的 重 写 方法 ): 
public class MailExpandA dapter implements 
ExpandableListAdapter,OnGroupClickListener,OnChildClickListener { 
private LayoutInflater mInflater; 
private Context mContext; 
private ArrayList<MailBox> mBoxList; 


public MailExpandAdapter(Context context, ArrayList<MailBox> box_list) í 
minflater = LayoutInflater.from(context); 
mContext = context; 
mBoxList = box list; 


(a Override 
public int getGroupCount() í 
return mBoxList.size(); 


(@Override 
public int getChildrenCount(int groupPosition) í 
return mBoxList.get(groupPosition).mail list.size(); 


(@Override 
public View getGroupView(int groupPosition, boolean isExpanded, View convertView, ViewGroup 


parent) { 


ViewHolderBox holder — null; 

if (convertView — null) í 
holder = new ViewHolderBox(); 
convertView = minflater.inflate(R.layout.item box, null); 
holderiv box = (ImageView) convertView.find ViewById(R.id.iv box); 
holdertv box = (TextView) convertView.find ViewById(R.id.tv box); 
holdertv count = (TextView) convertView.findViewById(R.id.tv count); 
convertView.setTag(holder); 

j else { 
holder = (ViewHolderBox) convertView.getTag(); 


; 
MailBox box = mBoxList.get(groupPosition); 
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holder.iv_box.setImageResource(box.box_icon); 
holder.tv_box.setText(box.box title); 
holder.tv__count.setText(box.mail_list.size()+" 33 BI"); 
return convertView; 


@Override 
public View getChildView(final int groupPosition, final int childPosition, 
boolean isLastChild, View convertView, ViewGroup parent) { 
ViewHolderMail holder = null; 
if (convertView == null) í 
holder = new ViewHolderMail(); 
convertView = mlnflater.inflate(R.layout.item mail, null); 
holder.ck mail = (CheckBox) convertView.find ViewById(R.id.ck mail); 
holder.tv date = (TextView) convertView.findViewById(R.id.tv date); 
convertView.setTag(holder); 
) else í 
holder = (ViewHolderMail) convertView.getTag(); 
J 
Mailltem item = mBoxList.get(groupPosition).mail list.get(childPosition); 
holder.ck mail.setText(item.mail title); 
holder.ck mail.setOnCheckedChangeListener(new OnCheckedChangeListener() { 
(à)Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) í 
MailBox box = mBoxList.get(groupPosition); 
Mailltem item — box.mail list.get(childPosition); 
String desc = String.format(" 您 点 击 了 %s, 标题 是 %s", box.box title, item.mail title); 
Toast.makeText(mContext, desc, Toast.LENGTH_SHORT).show(); 


j 
» 
holder.tv date.setText(item.mail date); 
return convertView; 
j 
(à Override 


public boolean isChildSelectable(int groupPosition, int childPosition) í 
return true; /如 果子 条 目 需 要 响应 点 击 事件 ， 这 里 就 要 返回 true 


public final class ViewHolderBox í 
public ImageView iv_box; 
public TextView tv_box; 
public TextView tv_count; 
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public final class ViewHolderMail í 
public CheckBox ck mail; 
public TextView tv. date; 


5 

@Override 

public boolean onChildClick(ExpandableListView parent, View v, int groupPosition, int childPosition, 

long id) { 

ViewHolderMail holder = (ViewHolderMail) v.getTag(); 
holder.ck_mail.setChecked(!(holder.ck_mail.isChecked())); 
return true; 

j 

(a Override 

public boolean onGroupClick(ExpandableListView parent, View v, int groupPosition, long id) í 
String desc = String.format(" 您 点 击 了 %s", mBoxList.get(groupPosition).box title); 
Toast.makeText(mContext, desc, Toast.LENGTH SHORT).show(); 
return false; /如 果 返 回 tue， 就 不 会 展示 子 列表 

; 

ji 


AAA E AR PA j AARRE ER NEAR FUE BE F: 


private void initMailBox() { 
ExpandableListView elv list = (ExpandableListView) findViewById(R.id.elv_list); 
final ArrayList<MailBox> box list = new ArrayListcMailBox^(); 
box list.add(new MailBox(R.drawable.mail folder inbox, " 收 件 箱 ", getRecvMail())); 
box list.add(new MailBox(R.drawable.mail folder outbox, "发 件 箱 ", getSentMail())); 
box list.add(new MailBox(R.drawable.mail folder draft, "草稿 箱 ", getDraftMail())); 
box list.add(new MailBox(R.drawable.mail folder recycle, " 废 件 箱 ", getRecycleMail())); 
MailExpandA dapter adapter = new MailExpandAdapter(this, box list); 
elv list.setAdapter(adapter); 
elv list.setOnChildClickListener(adapter); 
elv list.setOnGroupClickListener(adapter); 
elv listexpandGroup(0); /默认 展开 第 一 个 邮件 来 


电子 邮箱 的 展示 效果 如 图 10-37 和 图 10-38 所 示 。 其 中 ， 图 10-37 所 示 为 展开 收 件 箱 时 的 
初始 界面 ， 图 10-38 所 示 为 点 击 收 起 收 件 箱 后 ， 点 击 展开 发 件 箱 时 的 界面 。 
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D 收 件 箱 5 封 邮件 
记忆 这 里 是 收 件 箱 呀 1 2016 年 11 月 15 日 
这 里 是 收 件 箱 呀 2 2016 年 11 月 10 日 
[这 里 是 收 件 箱 呀 3 2016 年 11 月 14 日 
已 这 里 是 收 件 箱 呀 4 2016 年 11 月 1 日 
[jag utis 2016 年 11 月 13 日 
可 发 件 箱 5 封 邮 件 
B) 草稿 箱 5 封 邮件 


5 me 5 封 邮件 


D 收 件 箱 5 封 邮件 
可 发 件 箱 5 封 邮件 
已 邮件 发 出 去 了 中 1 2016 年 11 月 15 日 
邮件 发 出 去 了 吗 2 2016 年 11 月 14 日 
已 邮件 发 出 去 了 吗 3 2016 年 11 月 1 日 
邮件 发 出 去 了 吗 4 2016 年 11 月 13 日 
邮件 发 出 去 了 吗 5 2016 年 11 月 10 日 
BE 草稿 箱 5 封 邮 件 
m mra 5 封 邮 件 








图 10-37 展开 收 件 箱 时 的 初始 界面 图 10-38 点 击 展 开发 件 箱 时 的 界面 


可 折 登 列表 视图 有 时 会 出 现 孙 子 项 不 响应 点 击 事件 的 问题 ， 可 能 是 某 个 环节 没有 正确 设 
置 。 要 让 孙子 项 正常 响应 点 击 事件 ， 需 满足 下 面 3 个 条 件 : 


(1) 可 折合 列表 适配器 的 isChildSelectable 方法 要 返回 true, 

(2) 可 折 革 列表 视图 的 对 象 要 调用 setOnChildClickListener 方法 注册 孙子 项 的 点 击 监 听 
器 ， 并 重 写 该 监听 器 的 onChildClick 方法 。 

(D 孙子 项 目 中 若 存 在 Button、EditText 等 默认 占用 焦点 的 控件 ， 则 要 去 除 焦点 占用 ， 
即 调用 这 些 控件 的 setFocusable 和 setFocusableInTouchMode 方法 ， 并 设置 为 false。 也 可 参照 
第 5 章 “5.2.2 列表 视图 ListView” 中 处 理子 项 抢占 焦点 的 做 法 ， 给 列表 项 布局 文件 的 根 节点 
加 上 descendantFocusability 属性 ， 声 明 在 列表 项 范围 内 剥夺 下 级 控件 的 抢占 权利 ， 代 码 如 下 : 

android:descendantFocusability="blocksDescendants" 
10.5.8 ”代码 示例 
编码 方面 需要 注意 以 下 两 点 : 
CD 访问 网 络 、 文 件 上 传 与 下 载 时 ， 要 在 AndroidManifest.xml 添加 对 应 的 权限 配置 : 


<!-- 互联 网 -> 

<uses-permission android:name="android.permission.INTERNET" /> 

<!-- 查看 网 络 状态 -> 

<uses-permission android:name="android.permission.ACCESS_NETWORK STATE" > 
<uses-permission android:name="android.permission.ACCESS_WIFI STATE" > 

<!--SD 卡 -> 

<uses-permission android:name="android.permission.WRITE_ EXTERNAL STORAGE" > 
<uses-permission android:name-"android.permission READ EXTERNAL STORAGE" /> 
«uses-permission android:name-"android.permission MOUNT UNMOUNT FILESYSTEMS" /> 








(2) AndroidManifest.xml 的 application 节点 注意 补充 android:name-".MainA pplication" . 
另外 ， 要 注册 在 线 好 友 列 表 获取 和 消息 接收 的 广播 接收 器 ， 注 册 代 码 如 下 : 
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«receiver android:name=".ChatMainActivity$RecvMsgReceiver" > 
<intent-filter> 


«action android:name="com.example.network.RECV_MSG" > 
</intent-filter> 
</receiver> 


<receiver android:name=".QQContactActivity$GetListReceiver" > 
<intent-filter> 


<action android:name="com.example.network.GET LIST" /> 
</intent-filter> 
</receiver> 


因为 网 络 通信 需要 服务 端 配合 ， 所 以 服务 器 方面 需要 实现 3 个 后 台 功 能 。 


(1) 文件 上 传 功能 ， 源 码 参 见 本 书 下 载 资源 UploadTest 工程 里 的 UploadServletjava。 
(2) 获取 好 友 列 表 接 口 ， 源 码 参见 本 书 下 载 资源 UploadTest 工程 里 的 QueryFriend.java, 
(3) Socket 服 务 器 ， 源 码 参见 本 书 下 载 资源 的 Socket 工 程 ， 主 程序 入 口 在 ChatServer.java 中 。 
实战 项 目 不 但 要 在 真 机 上 测试 ， 而 且 要 开启 服务 端 程序 ， 这 样 才 能 真 刀 真 枪 地 模拟 即时 
通信 的 真实 场景 。 首 先 在 服务 器 上 分 别 启动 UploadTest T 
旺 和 Socket 工程 ， 然 后 准备 两 台 手 机 分 别 安装 实战 项 目 编 Losi 
译 后 的 App (HEAR: App 代码 中 的 URL 服务 地 址 必须 是 正 
确 的 服务 器 IP， 并 且 手 机 与 服务 器 在 同一 个 网 段 )， 接 着 
两 台 手 机 都 运行 实战 项 目的 聊天 App, 在 图 10-39 所 示 的 登 
录 页 面 输入 昵称 ， 点 击 登录 按钮 ， 进 入 好 友 列表 页 面 。 EN Spain wati 
好 友 列 表 的 页 面 效 果 如 图 10-40 和 图 10-41 所 示 。 其 中 ， 图 10-40 所 示 为 展开 在 线 好 友 分 
组 时 的 好 友 列 表 界 面 ， 可 以 看 到 手机 A 的 登录 昵称 是 “轻狂 飞扬 ”, 手机 B 的 登录 昵称 是 “大 
山 ”; 图 10-41 所 示 为 展开 亲戚 分 组 时 的 好 友 列 表 界 面 。 























图 10-40 展开 在 线 好 友 分 组 时 的 界面 图 10-41 ”展开 亲戚 分 组 时 的 列表 界面 
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两 台 手机 都 点 击 对 方 昵 称 ， 进 入 聊天 主页 面 ， 页 面 下 方 有 文本 编辑 框 ， 可 发 送 文本 消息 。 
左下 角 有 图 片 的 图 标 按钮 ， 点击 即 可 选择 图 片 并 发 送 图 片 消息 ; 图 片 按钮 右边 是 声音 的 图 标 按 
Hl, 点击 即 可 选择 音频 文件 并 发 送 声 音 消息 。 为 了 看 起 来 更 逼真 ， 消 息 窗口 采用 对 方 消息 靠 左 
对 齐 、 我 方 消息 靠 右 对 齐 的 布局 ， 并 给 双方 消息 着 不 同 的 背景 色 。 对 于 文本 消息 来 说 ， 双 方 消 
息 窗口 直接 展示 文字 内 容 就 可 以 了 ; 对 于 图 片 消息 来 说 , 消息 窗口 应 展示 图 片 的 缩 略图 ， 用 户 
点 击 缩 略图 后 ,再 展示 图 片 的 大 图 ; 对 于 声音 消息 来 说 ， 消 息 窗口 只 展示 声音 图 标 ， 一 旦 用 户 
点 击 声音 图 标 ， 系 统 就 开始 播放 对 应 的 声音 文件 。 

具体 测试 的 聊天 效果 如 图 10-42 一 图 10-45 所 示 。 其 中 , 图 10-42 和 图 10-43 所 示 为 手机 A 
(了 昵称 “ 轻 舞 飞扬 ”) 的 聊天 窗口 ， 图 10-44 和 图 10-45 所 示 为 手机 B (昵称 “大 山 ”) 的 聊 
天 窗口 。 


与 大 山 聊 天 与 大 山 聊 天 


大 山 2016.11-14 233806 
hi, AFD Bisd 
R^H$20161115002712 
ms Hue EBR kB 2016-11-15 003020 

L 2 m] 


ili 2016:11-14234247 


sd) 


1M 201611-142339 16. 
周末 我 去 公司 了 ， 好 多 鲜花 ， 


大 山 201611-14233949 











9b 
VERTUS 2016-11-15 00:32:13 

i) 

nj w 发 送 nw 发 送 
图 10-42 与 大 山 的 聊天 窗口 截图 1 图 10-43 与 大 山 的 聊天 窗口 截图 2 
network network 
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08 2016-11-14 23:43:36 





2368 
Bx o) 
四 中 E 
图 10-44 “与 轻 舞 飞扬 的 聊天 窗口 截图 1 1045 与 轻 舞 飞扬 的 聊天 窗口 截图 2 


至 此 , 实战 项 目 仿照 手机 QQ 基本 实现 了 聊天 功能 的 常用 操作 , 包括 实时 刷新 在 线 好 友 列 
表 、 发 送 与 接收 文本 消息 、 发 送 与 接收 图 片 消息 、 发 送 与 接收 声音 消息 等 。 当 然 ， 本 项 目 尚 有 
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CD 发 送 图 片 与 声音 时 ， 目 前 采用 文件 对 话 框 选择 具体 文件 。 其 实 可 参照 第 9 章 的 设备 
操作 ， 现 场 拍照 或 现场 录音 后 ,把 照片 和 录音 文件 直接 传 给 对 方 。 另 外 ， 可 增加 对 视频 消息 的 
发 送 与 接收 处 理 。 

(2) 目前 聊天 消息 没有 保存 到 本 地 数据 库 ， 因 此 下 次 打开 对 方 的 聊天 窗口 无 法 查看 之 前 
的 聊天 记录 。 可 参照 第 4 章 的 SQLite 数据 库 操 作 把 聊天 消息 保存 到 SQLite 中 ， 这 样 每 次 打开 
聊天 窗口 时 都 会 到 数据 库 中 查找 并 显示 历史 聊天 记录 。 

(3) 把 第 9 章 的 实战 项 目 “ 仿 微 信 的 发 现 功能 ”集成 到 本 章 的 实战 项 目 中 ， 增 强 这 个 聊 
天 App 的 实用 性 和 趣味 性 。 


还 等 什么 呢 ? 快 快 行动 起 来 ， 打 造 一 个 专属 的 即时 通信 App 吧 ! 
下 面 是 好 友 列 表 页 面 的 代码 ， 更 多 聊天 代码 参见 本 书 下 载 资源 的 源码 : 


public class QQContactActivity extends AppCompatActivity implements 
OnClickListener, OnQueryFriendL istener í 
private final static String TAG = "QQContactActivity"; 
private static Context mContext; 
private static ExpandableListView elv friend; 
private static ArrayList<FriendGroup> mGroupList; 
private static FriendGroup mGroupOnline = new FriendGroup(); 





(@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity qq contact); 
Toolbar tl head = (Toolbar) find ViewById(R.id.tl head); 
tl. head.setTitle(getResources().getString(R.string.menu second)); 
setSupportActionBar(tl head); 
tl head.setNavigationOnClickListener(new OnClickListener() í 
@Override 
public void onClick(View view) { 
finish(); 
; 
» 
mContext — getApplicationContext(); 
mGroupOnline.title = "在 线 好 友 "; 
mGroupList = new ArrayList<FriendGroup>(); 
elv friend = (ExpandableListView) findViewByld(R.id.elv_friend); 
findViewByld(R.id.btn refresh).setOnClickListener(this); 
QueryFriendTask queryTask = new QueryFriendTask(this); 
query Task.setOnQueryFriendListener(this ); 
query Task.execute(); 
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$ 
@Override 
public void onQueryFriend(String resp) { 
try { 
JSONObject obj = new JSONObject(resp); 
JSONArray groupArray = obj.getJSONArray("group list"); 
for (int i-0; icgroupArray.length(); i+) í 
JSONObject groupObj = groupArray.getJSONObject(i); 
FriendGroup group = new FriendGroup(); 
group.title = groupObj.getString("title"); 
JSONArray friendArray = groupObj.getJSONArray("friend list"); 
for (int j=0; j«friendArray.length(); j++) í 
JSONObject friendObj = friendArray.getJSONObject(j ); 
Friend friend — new Friend("", friendObj.getString("name"), ""); 
group.friend list.add(friend); 
J 
mGroupList.add(group); 
; 
showAllFriend(); 
} catch (JSONException e) { 
e.printStackTrace(); 
Toast.makeText(this, "获取 全 部 好 友 列 表 出 错 : "e getMessage(), 
Toast.LENGTH_SHORT).show(); 
j 
j 
@Override 


protected void onResume() { 
mHandler.postDelayed(mRefresh, 500); 
super.onResume(); 


@Override 

protected void onDestroy() { 
MainApplication.getInstance().sendAction(ClientThread. LOGOUT, "", ""); 
super.onDestroy(); 


private Handler mHandler = new Handler(); 
private Runnable mRefresh = new Runnable() í 
(GQOverride 
public void run() í 
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MainApplication.getInstance().sendAction(ClientThread.GETLIST, "", ""); 


h 


@Override 
public void onClick(View v) { 
if (v.getId() = R.id.btn refresh) í 
mHandler.post(mRefresh); 


public static class GetListReceiver extends BroadcastReceiver í 
(aJOverride 
public void onReceive(Context context, Intent intent) í 
if (intent !— null) í 
Log.d(TAG, "onReceive"); 
String content = intent.getStringExtra(ClientThread. CONTENT); 
if (mContext != null && content != null && content.length() > 0) í 
showFriendOnline(content); 


private static void showFriendOnline(String content) í 
int pos = content.indexOf(ClientThread.SPLIT LINE); 
String head = content.substring(0, pos); 
String body = content.substring(pos + 1); 
String[] splitArray = head.split(ClientThread.SPLIT ITEM); 
if (splitArray[0].equals(ClientThread.GETLIST)) { 
String[] bodyArray = body.split("W"); 
ArrayList<Friend> friendList = new ArrayList-Friend^(); 
for (int i = 0; i < bodyArray.length; i++) í 
String[] itemArray = bodyArray[i].split(ClientThread.SPLIT ITEM); 
if (bodyArray[i].length() > 0 && itemArray != null && itemArray.length >= 3) í 
friendList.add(new Friend(itemArray[0], itemArray[1], itemArray[2])): 


; 
mGroupOnline.friend list = friendList; 
showAllFriend(); 
1) else í 
String hint = String.format("%s\n%s", splitArray[0], body); 
Toast.makeText(mContext, hint, ToastLENGTH_SHORT).show(); 
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private static void showAllFriend() í 
ArrayList-FriendGroup- all group = new ArrayList«FriendGroup^(); 
all. group.add(mGroupOnline); 
all group.addAll(mGroupList); 
FriendExpandA dapter adapter = new FriendExpandAdapter(mContext, all group); 
elv friend.setAdapter(adapter); 
elv friend.setOnChildClickListener(adapter); 
elv friend.setOnGroupClickListener(adapter); 
elv friend.expandGroup(0); /默认 展开 在 线 好 友 


10.6 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 网 络 通信 相关 技术 ， 包 括 多 线程 的 工作 机 制 和 用 法 〈 消 
息 传递 、 进 度 对 话 框 、 异 步 任 务 、 异 步 服务 ) 、HTTP 接口 访问 的 方式 〈 网 络 连接 检查 、 移 动 
数据 格式 、HTTP 接口 调用 、HTTP 图 片 获 取 ) 、 文 件 上传 和 下 载 的 实现 与 用 法 〈 下 载 管理 器 、 
文件 对 话 框 、 文 件 上 传 )、 套 接 字 的 应 用 (网 络 地 址 、Socket 通信 ) 。 最 后 设计 了 一 个 实战 项 
目 “ 仿 手机 QQ 的 聊天 功能 ”， 详 细 曾 述 了 即时 通信 技术 的 原理 与 设计 思路 。 在 该 项 目的 App 
编码 中 ， 采 用 了 本 章 介绍 的 大 部 分 网 络 通信 知识 ， 实 现 了 文本 消息 、 图 片 消息 、 声 音 消 息 的 发 
送 与 接收 。 另 外 ， 介 绍 了 如 何 使 用 可 折 对 列表 视图 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 

(1) 学 会 在 合适 的 场合 使 用 多 线程 技术 。 

(2) 学 会 HTTP 方式 的 接口 调用 与 图 片 获 取 。 

G) 学 会 管理 文件 上 传 和 下 载 操作 。 

(4) 学 会 运用 Socket 通信 技术 进行 聊天 应 用 的 开发 。 
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KEMA App 开发 常见 的 一 些 事件 处 理 技术 ， 主 要 包 
括 如 何 检测 并 接管 按键 事件 ,如 何 对 触摸 事件 进行 分 发 、 拦 
截 与 处 理 ， 如何 实现 手势 检测 与 飞 掠 视图 的 联合 运用 , 如 何 
正确 避免 手势 冲突 的 意外 状况 。 最 后 结合 本 章 所 学 的 知识 演 
示 一 个 实战 项 目 “ 抠 图 神器 一 - 美 图 变 变 ”的 设计 与 实现 。 
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11.1 “按键 事件 


本 节 介 绍 App 开发 对 按键 事件 的 检测 与 处 理 ， 首 先 说 明 如 何 检测 控件 对 象 的 按键 事件 ; 
然后 说 明 如 何 检测 活动 页 面 的 物理 按键 ， 并 以 返回 键 为 例 阐述 “再 按 一 次 返回 键 退出 ”的 功能 
实现 ; 最 后 以 音量 调节 对 话 框 为 例 ， 介 绍 如 何 接管 音量 按键 的 处 理 。 


11.1.1. 检测 软 键盘 


- 般 不 对 手机 上 的 输入 按键 进行 处 理 ， 直 接 由 系统 按照 默认 情况 操作 。 当 然 有 时 为 了 改 
善 用 户 体验 ， 需 要 让 App 拦截 按键 事件 ， 并 进行 额外 处 理 。 在 第 3 章 介绍 编辑 框 EditText 的 
用 法 时 提 到 监控 输入 字符 中 的 回 车 键 , 一 旦 发 现 用 户 襄 了 回 车 键 , 就 将 焦点 自动 移 到 下 一 个 控 
件 ， 而 不 是 在 编辑 框 输入 回 车 换行 。 当 时 的 字符 输入 拦截 采用 注册 文本 观测 器 TextWatcher 实 
I, 但 该 监听 器 只 适用 于 编辑 框 控件 ， 无 法 用 于 其 他 控件 。 因此 ， 若 想 让 其 他 控件 能 够 监听 按 
键 操作 ， 则 要 另外 调用 控件 对 象 的 setOnKeyListener 方法 设置 按键 监听 器 ， 并 实现 监听 器 接口 
OnKeyListener 的 onKey 方法 。 

要 监控 按键 事件 ， 首 先 得 知道 每 个 按键 的 编码 ， 这 样 才能 根据 不 同 的 编码 值 进行 相应 的 
处 理 。 按 键 编码 的 取 值 说 明 见 表 11-1。 这 里 注意 ， 监 听 器 OnKeyListener 只 会 检测 控制 键 ， 不 
会 检测 文本 键 〈 字 母 、 数 字 、 标 点 等 ) 。 


表 11-1 按键 编码 的 取 值 说 明 























按键 编码 KeyEvent 类 的 按键 名 称 说 明 

3 KEYCODE_HOME 主页 键 〈 未 开放 给 普通 App) 
4 KEYCODE BACK 返回 键 〈 后 退 键 ) 

24 KEYCODE VOLUME UP 加 大 音量 键 

25 KEYCODE VOLUME DOWN 减 小 音量 键 

26 KEYCODE POWER 电源 键 ( 未 开放 给 普通 App) 
66 KEYCODE ENTER 回 车 键 

67 KEYCODE DEL MRE GERED 

82 KEYCODE MENU 菜单 键 

84 KEYCODE SEARCH 搜索 键 

187 KEYCODE APP SWITCH 任务 键 ( 未 开放 给 普通 App) 








实际 监控 结果 显示 , 每 次 按 控 制 键 时 ，onKey 方法 都 会 收 到 两 次 重复 编码 的 按键 事件 ， 这 
是 因为 该 方法 把 每 次 按键 都 分 成 按 下 与 松 开 两 个 动作 , 所 以 一 次 按键 变 成 了 两 个 按键 动作 。 解 
决 这 个 问题 的 办 法 很 简单 ， 就 是 只 监控 按 下 动作 (KeyEvent.ACTION_DOWN) 的 按键 事件 ， 
不 监控 松 开动 作 (KeyEvent.ACTION_UP) 的 按键 事件 。 

下 面 是 使 用 软 键盘 监听 器 的 代码 : 


EVE 
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public class KeySoftActivity extends AppCompatActivity implements OnKeyListener { 
private EditText et. soft; 
private TextView tv result; 
private String desc — ""; 


(@Override 

protected void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity key soft); 
et soft = (EditText) find ViewById(R.id.et soft); 
tv result = (TextView) findViewById(R.id.tv result); 
et soft.setOnKeyListener(this); 


@Override 
public boolean onKey(View v, int keyCode, KeyEvent event) { 
if (event.getAction()=-=KeyEvent.ACTION_DOWNJ) í 

desc = String.format("%s 输入 的 软 按键 编码 是 %d, 动 作 是 按 下 ", desc, keyCode); 

if (keyCode 一 KeyEvent.KEYCODE ENTER) í 
desc = String.format("%s， 按 键 为 回 车 键 ", desc); 

) else if (keyCode — KeyEvent.KEYCODE DEL) í 
desc = String.format("%s， 按 键 为 删除 键 ", desc); 

} else if(keyCode = KeyEvent.KEYCODE BACK) í 
desc = String.format("%s， 按 键 为 返回 键 ", desc); 
mHandler.postDelayed(mFinish, 3000); 

} else if (keyCode = KeyEvent.KEYCODE MENU) { 
desc = String.format("%s， 按 键 为 菜单 键 ", desc); 

} else if (keyCode — KeyEvent.KEYCODE VOLUME UP) ( 
desc = String.format("%s， 按 键 为 加 大 音量 键 ", desc); 

} else if (keyCode = KeyEvent.KEYCODE VOLUME DOWN) ( 
desc = String.format("%s， 按 键 为 减 小 音量 键 ", desc); 

desc = desc + "n"; 

tv_result.setText(desc); 

return true; 

} else { 
return false; /返回 true 表示 处 理 完 了 不 再 输入 该 字符 ， 返 回 false 表示 输入 该 字符 


private Handler mHandler = new Handler(); 
private Runnable mFinish = new Runnable() í 


@Override 








# # #!l E 





public void run() í 
finish(); 
J 


; 
上 述 代码 的 按键 效果 如 图 11-1 所 示 。 虽 然 按 键 编码 表 存 在 首页 键 、 任 务 键 、 电 源 键 的 定 
义 ， 但 这 3 个 键 并 不 开放 给 普通 App， 普 通 App 也 不 应 该 拦截 这 些 按键 事件 。 


hello 


输入 的 软 按键 编码 是 66, 动 作 是 按 下 , 按键 为 回 车 键 


输入 的 软 按键 编码 是 67, 动 作 是 按 下 , 按键 为 删除 键 
输入 的 软 按键 编码 是 24, 动 作 是 按 下 , 按键 为 加 大 音量 键 
输入 的 软 按 键 编码 是 25, 动 作 是 按 下 , 按键 为 减 小 音量 键 
输入 的 软 按 键 编码 是 82, 动 作 是 按 下 , 按键 为 菜单 键 
输入 的 软 按键 编码 是 4, 动 作 是 按 下 , 按键 为 返回 键 


图 11-1 软 键盘 的 检测 结果 





11.1.2 ”检测 物理 按键 
除了 给 控件 注册 按键 监听 器 外 ， 还 可 以 直接 在 活动 页 面 上 检测 物理 按键 ， 即 重 写 Activity 
的 onKeyDown 方法 。onKeyDown 方法 的 使 用 与 前 面 的 onKey 方法 类 似 ， 拥 有 按键 编码 与 按 
键 事件 KeyEvent 两 个 参数 ， 当 然 这 两 个 方法 也 存在 不 同 之 处 ， 具 体 说 明 如 下 : 
(1) onKeyDown 只 能 在 Activity 代码 中 使 用 ， 而 onKey 只 要 有 可 注册 的 控件 就 能 使 用 。 
(2) onKeyDown 只 能 检测 物理 按键 ， 无 法 检测 输入 法 按键 〈 如 回 车 键 、 删 除 键 等 ) ， 而 


onKey 可 同时 检测 两 类 按键 。 
(3) onKeyDown 不 区 分 按 下 与 松 开 两 个 动作 ， 而 onKey 区 分 这 两 个 动作 。 


下 面 是 启用 物理 按键 监听 的 代码 片段 : 


(QOverride 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
desc = String.format("%s 物理 按键 的 编码 是 %d", desc, keyCode); 
if (KeyCode = KeyEvent. KEYCODE BACK) ( 
desc = String.format("%s， 按 键 为 返回 键 " desc); 
mHandler.postDelayed(mFinish, 3000); 
} else if (keyCode = KeyEvent.KEYCODE MENU) í 
desc = String.format("%s， 按 键 为 菜单 键 ", desc); 
} else if (keyCode 一 KeyEventKEYCODE VOLUME UP) í 
desc = String.format("%s， 按 键 为 加 大 音量 键 ", desc); 
} else if (keyCode = KeyEvent. KEYCODE VOLUME DOWN) í 
desc = String.format("%s， 按 键 为 减 小 音量 键 ", desc); 
; 


desc = desc + "n"; 
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tv result.setText(desc); 
return true; /返回 true 表示 不 再 响应 系统 动作 ， 返 回 false 表示 继续 响应 系统 动作 


private Handler mHandler = new Handler(); 
private Runnable mFinish = new Runnable() í 
@Override 
public void run() í 
finish(); 
b 
B 
物理 按键 的 监听 效果 如 图 11-2 所 示 。 对 于 目前 的 
智能 手机 来 说 , 普通 App 只 可 检测 4 个 物理 按键 事件 ， 
即 菜单 键 、 返 回 键 、 加 大 音量 键 和 减 小 音量 键 。 NE EATA 


- x 物理 按键 的 编码 是 24, 按键 为 加 大 音量 刍 
检测 物理 按键 最 常见 的 应 用 是 淘宝 主页 的 “再 按 Pm ayau A2 up uni 
-次 返回 键 退出 ”， 在 App 首页 按 返 回 键 ， 系 统 默认 — pessum ea, 按键 为 返回 键 
的 做 法 是 直接 退出 该 App。 然 而 用 户 有 可 能 不 小 心 按 了 图 11.2 物理 按键 的 检测 结果 
返回 键 ， 并 非 想 退出 该 App， 因 此 这 里 加 一 个 小 提示 ， 
等 待 用 户 再 次 按 返 回 键 才 会 确认 退出 意图 ， 并 执行 退出 操作 。 
“再 按 一 次 返回 键 退 出 ”的 实现 代码 很 简单 ， 在 onKeyDown 方法 中 拦截 返回 键 即 可 ， 具 
体 代码 如 下 : 
private boolean bExit = false; 
@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) { 
if (keyCode = KeyEvent.KEYCODE_BACK) { 
if (bExit) { 
finish(); 
} 
bExit = true; 
Toast.makeText(this, "再 按 一 次 返回 键 退出 必 Toast. LENGTH. SHORT).show(); 
return true; 
) else ( 
return super.onKeyDown(keyCode, event); 











j 
} 


重 写 Activity 代码 的 onBackPressed 方法 可 实现 同样 的 效果 ， 该 方法 专门 响应 按 返 回 键 事 
件 ， 具 体 代码 如 下 : 


private boolean bExit = false; 
(QOverride 
public void onBackPressed() í 





= 





# # SX 





if (bExit) í 
finish(); 
return; 
; 
bExit — true; 
Toast. makeText(this, "再 按 一 次 返回 键 退出 !", Toast. LENGTH. SHORT).show(); 
} 


该 功能 的 界面 效果 如 图 11-3 所 示 。 这 是 一 个 提示 小 窗口 , 在 淘宝 主页 按 返 回 键 时 能 够 看 到 。 


再 按 一 次 返回 键 退出 ! 


图 11-3 “再 按 一 次 返回 键 退出 ”的 提示 窗口 
11.1.3 音量 调节 对 话 框 


除了 检测 回 车 键 与 返回 键 ， 音量 键 也 常常 需要 拦截 。 第 9 章 提 到 Android 有 6 类 铃 音 ， 分 
别 是 通话 音 、 系 统 音 、 铃 音 、 媒 体 音 、 闻名 音 和 通知 音 ， 不 过 音量 键 只 与 减少 两 个 键 ， 
当 用 户 按 音量 增加 键 时 ， jue 怎么 知道 用 户 希望 加 大 哪 类 铃 音 的 音量 呢 

要 解决 这 个 问题 ， 最 好 是 弹出 一 个 对 话 框 ， 让 用 户 ip 音 类 型 ， 并 显示 拖 
动 条 , 方便 用 户 把 音量 一 次 调整 到 位 , 不 必 连 续 按 增 加 键 或 减 小 键 。 自 定义 音量 对 话 框 还 有 一 
个 好 处 ， 即 允许 定制 对 话 框 的 界面 风格 与 显示 位 置 ， 这 在 播放 音乐 和 播放 电影 时 尤其 适用 。 

因为 自 定义 对 话 框 的 代码 不 在 Activity 中 ， 所 以 无 法 通过 onKeyDown 方法 检测 按键 ， 只 
能 给 拖 动 条 注册 按键 监听 器 OnKeyListener。 自 定义 音量 调节 对 话 框 的 代码 如 下 : 

public class VolumeDialog implements OnSeekBarChangeListener, OnKeyListener { 

private Dialog dialog; 





























private View view; 

private SeekBar sb music; 

private AudioManager mAudioMgr; 

private int MUSIC = AudioManager.STREAM MUSIC; 
private int mMax Volume; 

private int mNow Volume; 


public VolumeDialog(Context context) í 
maAudioMgr = (AudioManager) context.getSystemService(Context. AUDIO SERVICE); 
mMax Volume = mAudioMgr.getStreamMaxVolume(MUSIC); 
mNow Volume = mAudioMgr.getStreamVolume(MUSIC); 
view = LayoutInflater.from(context).inflate(R.layout.dialog volume, null); 
dialog — new Dialog(context, R.style. VolumeDialog); 
sb music = (SeekBar) view.findViewById(R.id.sb music); 
sb music.setOnSeekBarChangeListener(this); 
sb music.setProgress(sb music.getMax() * mNowVolume/mMaxVolume); 
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public void show() í 
dialog.getWindow().setContentView(view); 
dialog.getWindow().setLayout( 
LayoutParams. MATCH PARENT, LayoutParams. WRAP CONTENT); 
dialog.show(); 
sb music.setFocusable(true); 
sb music.setFocusablelnTouchMode(true); 
sb music.setOnKeyListener(this); 


public void dismiss() { 
if (dialog != null && dialog.isShowing()) í 
dialog.dismiss(); 


public boolean isShowing() í 
if (dialog != null) í 
return dialog.isShowing(); 
) else ( 
return false; 


public void adjustVolume(int direction, boolean fromActivity) í 
if (direction — AudioManager.ADJUST RAISE) í 
mNow Volume += 1; 
) else í 
mNow Volume -= 1; 
J 
sb music.setProgress(sb music.getMax() * mNow Volume/mMaxVolume); 
maAudioMgr.adjustStream Volume(MUSIC, direction, AudioManager.FLAG PLAY SOUND); 
if (mListener != null && fromActivity!-true) f 
mListener.onVolumeAdjust(mNow Volume); 


j 


close(); 


private void close() í 
mHandler.removeCallbacks(mClose); 
mHandler.postDelayed(mClose, 2000); 





# 件 Sn 





private Handler mHandler = new Handler(); 
private Runnable mClose = new Runnable() í 
@Override 
public void run() { 
dismiss(); 


h 


@Override 
public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) { 
} 


(@Override 
public void onStartTrackingTouch(SeekBar seekBar) í 
j 


(@Override 
public void onStopTrackingTouch(SeekBar seekBar) í 
mNow Volume = mMax Volume * seekBar.getProgress()/seekBar.getMax(); 
mAudioMgr.setStreamVolume(MUSIC, mNow Volume, AudioManager.FLAG PLAY SOUND); 
if (mListener !— null) í 
mListener.onVolumeAdjust(mNow Volume); 
J 


close(); 


(@Override 
public boolean onKey(View v, int keyCode, KeyEvent event) í 
if (keyCode = KeyEven.KEYCODE VOLUME UP && event.getAction()—KeyEvent. 
ACTION DOWN) í 
adjust Volume(AudioManager.ADJUST RAISE, false); 
return true; 
} else if (keyCode = KeyEven.KEYCODE VOLUME DOWN &x& event.getAction()— 
KeyEvent. ACTION. DOWN) í 
adjustVolume(AudioManager. ADJUST LOWER, false); 
return true; 
} else í 


return false; 
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private VolumeAdjustListener mListener; 
public void setVolumeAdjustListener( VolumeA djustListener listener) í 
mListener = listener; 


public static interface VolumeAdjustListener í 
public abstract void on VolumeAddjust(int volume); 


} 
在 页 面 代码 中 通过 检测 音量 增加 键 和 减 小 键 弹出 音量 对 话 框 ， 代 码 如 下 : 


public class VolumeSetActivity extends AppCompatActivity implements VolumeAdjustListener { 
private TextView tv volume; 
private VolumeDialog dialog; 
private AudioManager mAudioMgr; 


(a Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity volume set); 
tv volume = (TextView) findViewByld(R.id.tv volume); 
mAudioMgr = (AudioManager) getSystemService(Context.AUDIO SERVICE); 


(@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) í 
if (keyCode = KeyEvent.KEYCODE VOLUME UP && event.getAction()—KeyEvent. 
ACTION DOWN) í 
showVolumeDialog(AudioManager.ADJUST RAISE); 
return true; 
} else if (keyCode = KeyEven.KEYCODE VOLUME DOWN &k& event.getAction()— 
KeyEvent. ACTION DOWN) í 
showVolumeDialog(AudioManager.ADJUST LOWER); 
return true; 
} else if (keyCode = KeyEvent.KEYCODE BACK) í 
finish(); 
return false; 
) else { 
return false; 


private void showVolumeDialog(int direction) f 
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if (dialog—null || dialog.isShowing()!=true) í 
dialog = new VolumeDialog(this); 
dialog.setVolumeA djustListener(this); 
dialog.show(); 
; 
dialog.adjustVolume(direction, true); 
onVolumeAdjust(mAudioMgr.getStreamVolume(AudioManager.STREAM MUSIC)); 
1 


@Override 
public void onVolumeA djust(int volume) í 
tv_volume.setText(" 调 节 后 的 音乐 音量 大 小 为 : "+volume); 
i 
} 


音量 调节 对 话 框 的 效果 如 图 11-4 和 图 11-5 所 示 。 其 中 ， 图 11-4 所 示 为 在 主页 面 按 音量 
增加 键 时 弹出 音量 对 话 框 的 界面 ; 用 户 把 对 话 框 上 的 拖 动 条 向 左 拉 ,以 大 幅 减 小 音乐 音量 ,此 
时 的 音量 对 话 框 界面 如 图 11-5 所 示 。 


CEC] 


11-4 按 音量 增加 键 弹 出 对 话 框 图 11-5 ”把 对 话 框 上 的 拖 动 条 往 左 拉 
11.2 ”触摸 事件 


本 节 介绍 对 屏幕 触摸 事件 的 相关 处 理 ， 首 先 说 明 手势 事件 的 分 发 流程 ， 包 括 3 个 手势 方 
ik. 3 类 手势 执行 者 、 派 发 与 拦截 处 理 ; 然后 说 明 手 势 事 件 的 具体 用 法 ， 包 括 单 点 触摸 和 多 点 
触 控 ， 最 后 阐述 一 个 手势 触摸 的 具体 应 用 写 签名 功能 的 实现 。 


11.2.1 手势 事件 的 分 发 流程 


智能 手机 的 一 大 革命 性 技术 是 把 屏幕 变 为 可 触摸 设备 ， 既 可 用 于 信息 输出 《显示 界面 ) 
又 可 用 于 信息 输入 《检测 用 户 的 触摸 行为 ) 。 为 方便 开发 者 使 用 ，Android 已 经 自动 识别 特定 
的 几 种 触摸 手势 , 包括 按钮 的 点 击 事件 (OnClickListener) 、 长 按 事件 COnLongClickListener) ~ 
滚动 视图 ScrollView 的 上 下 滚动 事件 、 翻 页 视图 ViewPager 的 左右 翻 页 事件 等 。 不 过 对 于 App 的 
高 级 开发 来 说 ， 系 统 自 带 的 几 个 固定 手势 显然 无 法 满足 丰富 多 变 的 业务 需求 。 这 时 就 要 求 开 发 者 
深入 了 解 触摸 行为 的 流程 与 方法 ， 并 在 合适 的 场合 接管 触摸 行为 ， 进 行 符合 需求 的 事件 处 理 。 

与 手势 事件 有 关 的 方法 主要 有 3 个 〈 按 执行 顺序 排列 ) : dispatchTouchEvent 、 


onInterceptTouchEvent 和 onTouchEvent。 
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e dispatchTouchEvent: 进行 事件 分 发 处 理 ， 返 回 结果 表示 该 事件 是 否 需要 分 发 。 默 认 返 回 
true 表示 分 发 给 下 级 视图 ， 由 下 级 视图 处 理 该 手势 ， 不 过 最 终 是 否 分 发 成 功 还 得 根据 
onInterceptTouchEvent 方法 的 拦截 判断 结果 ; 返回 false 表示 不 分 发 ， 此 时 必须 实现 自身 
的 onTouchEvent 方法 ， 否 则 该 手势 将 不 会 得 到 处 理 。 

e onlnterceptTouchEvent: 进行 事件 拦截 处 理 , 返回 结果 表示 当前 容器 是 否 需要 拦截 该 事件 。 
返回 tme 表 示 予 以 拦截 , 该 手势 不 会 分 发 给 下 级 视图 ,此 时 必须 实现 自身 的 onTouchEvent 
方法 ， 否 则 该 手势 将 不 会 得 到 处 理 ; 默认 返回 fase 表示 不 拦截 ， 该 手势 会 分 发 给 下 级 视 
图 进行 后 续 处 理 。 

e onTouchEvent 进行 事件 触摸 处 理 ， 返 回 结果 表示 该 事件 是 否 处 理 完毕 。 返 回 true 表示 
处 理 完毕 ， 无 须 处 理 上 级 视图 的 onTouchEvent 方法 ， 一 路 返回 结束 流程 ; 返回 false 表 
示 该 手势 事件 尚未 完成 ， 返 回 继续 处 理 上 级 视图 的 onTouchEvent 方法 ， 然 后 根据 上 级 
onTouchEvent 方法 的 返回 值 判断 直接 结束 或 由 上 上 级 处 理 。 

上 述 手势 方法 的 执行 者 有 3 个 〈 按 执行 顺序 排列 ) : 页 面 类 、 容 器 类 和 控件 类 。 

e 页 面 类 : 包括 Activity 及 其 派生 类 。 页 面 类 可 操作 dispatchTouchEvent 和 onTouchEvent 
两 种 方法 。 

° 容器 类 : 包括 从 ViewGroup 类 派生 出 的 各 类 容器 ， 如 各 种 布局 Layout， 以 及 ListView、 
GridView 、 Spinner 、 ViewPager 、 RecyclerView 、 Toolbar 等 。 容 器 类 可 操作 
dispatchTouchEvent. onInterceptTouchEvent 和 onTouchEvent 三 种 方法 。 


° 控件 类 : 包括 从 View 类 派生 的 各 类 控件 ， 如 TextView. ImageView. Button 等 。 控 件 类 
可 操作 dispatchTouchEvent 和 onTouchEvent 两 种 方法 。 


可 以 看 出 , 只 有 容器 类 才能 操作 onInterceptTouchEvent 方法 , 这 是 因为 该 方法 用 于 拦截 发 
往 下 层 视 图 的 事件 ， 而 控件 类 已 经 位 于 底层 ， 只 能 被 拦截 ， 不 能 拦截 别人 。 页 面 类 不 拥有 下 层 
视图 ， 所 以 不 能 操作 onInterceptTouchEvent 方法 。 

以 上 涉及 3 个 手势 方法 和 3 种 手势 执行 者 ， 其 中 手势 流程 的 排列 组 合 千变万化 ， 并 不 容 
易 解释 清楚 。 对 于 实际 开发 来 说 , 真正 需要 处 理 的 组 合并 不 多 ,所 以 只 要 把 常见 的 几 种 组 合 搞 
清楚 ， 就 能 应 付 大 部 分 开发 工作 。 

首先 是 页 面 类 的 手势 处 理 ， 其 dispatchTouchEvent 必须 返回 true， 因 为 如 果 不 分 发 ， 页 面 
上 的 视图 就 无 法 处 理 手 势 。 至 于 页 面 类 的 onTouchEvent， 基 本 没什么 作用 ， 因 为 手势 动作 由 具 
体 视图 处 理 ， 页 面 直接 处 理 手势 没什么 意义 。 所 以 页 面 类 的 手势 处 理 可 以 不 用 关心 ， 直 接 略 过 。 

其 次 是 控件 类 的 手势 处 理 ， 其 dispatchTouchEvent 没有 任何 作用 ， 因 为 控件 下 面 没有 下 级 
视图 ， 无 所 谓 分 不 分 发 。 至 于 控件 类 的 onTouchEvent， 如 果 要 进行 手势 处 理 ， 就 需要 自 定义 
一 个 控件 ， 重 写 自 定义 类 中 的 onTouchEvent 方法 ; 如 果 不 想 自 定义 控件 ， 就 直接 调用 控件 对 
象 的 setOnTouchListener 方法 ， 注 册 一 个 触摸 监听 器 OnTouchListener， 并 实现 该 监听 器 的 
onTouch 方法 。 所 以 控件 类 的 手势 处 理 只 需 关 心 onTouchEvent 方法 。 

最 后 是 容器 类 的 手势 处 理 ， 这 才 是 真正 要 深入 了 解 的 地 方 。 容 器 类 的 dispatchTouchEvent 
与 onInterceptTouchEvent 两 个 方法 都 能 决定 是 否 将 手势 交 给 下 级 视图 处 理 ,为 了 避免 手势 响应 
冲突 ,一般 要 重 写 dispatchTouchEvent 方法 或 onInterceptTouchEvent 方法 。 这 两 个 方法 之 间 的 
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区 别 可 以 这 么 理解 : 前 者 是 大 领导 ， 只管 派发 任务 ,不 会 自己 做 事情 ; 后 者 是 小 领导 ,尽管 有 
拦截 的 权利 ， 不 过 也 得 自己 做 点 事情 ， 比 如 处 理 纠纷 。 容 器 类 的 onTouchEvent 近乎 摆设 ， 因 
为 需要 拦截 的 在 前 面 已 经 拦截 了 , 需要 处 理 的 在 下 级 视图 已 经 处 理 了 , 很 少 会 兜 一 大 圈 在 这 儿 
处 理 。 
经 过 上 面 的 详细 分 析 ， 常 见 的 手势 处 理 方法 有 下 面 3 种 。 


e 容器 类 的 dispatchTouchEvent 方法 : 控制 事件 的 分 发 ， 决 定 把 手势 交 给 谁 处 理 。 
o 容器 类 的 onInterceptTouchEvent 方法 : 控制 事件 的 拦截 ， 决 定 是 否 要 把 手势 交 给 下 级 视 
图 处 理 。 
o 控件 类 的 onTouchEvent 方法 : 进行 手势 事件 的 具体 处 理 。 
下 面 是 一 个 不 派发 事件 的 自 定义 布局 代码 : 
public class NotDispatchLayout extends LinearLayout í 
public NotDispatchLayout(Context context) í 


super(context); 
j 














public NotDispatchLayout(Context context, AttributeSet attrs) { 
super(context, attrs); 
1 


(@Override 
public boolean dispatchTouchEvent(MotionE vent ev) í 
if (mListener != null) í 
mListener.onNotDispatch(); 
J 
return false; / 一 般 容器 默认 返回 true， 即 允许 分 发 给 下 级 
} 


private NotDispatchListener mListener; 
public void setNotDispatchListener(NotDispatchListener listener) í 
mListener = listener; 


j 


public static interface NotDispatchListener í 
public abstract void onNotDispatch(); 
; 
J. 


活动 页 面 实现 的 onNotDispatch 方法 代码 如 下 : 


public void onNotDispatch() í 
desc no = String.format("%s%s 触摸 动作 未 分 发 ， 接 钮 点 击 不 了 了 " 
, desc no, DateUtil.getNowTime()); 
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tv dispatch no.setText(desc no); 
} 
不 派发 事件 的 处 理 效 果 如 图 11-6 和 图 11-7 所 示 。 其 中 ， 图 11-6 的 上 面部 分 为 正常 布局 ， 
此 时 按钮 可 正常 响应 点 击 事件 ， 图 11-7 的 下 面部 分 为 不 派发 布局 ， 此 时 按钮 不 会 响应 点 击 事 
件 ， 取 而 代 之 的 是 执行 不 派发 布局 的 onNotDispatch 方法 。 











这 里 允许 分 发 给 下 级 这 里 允许 分 发 给 下 级 
13:57:29 您 点 击 了 按钮 13:57:29 您 点 击 了 按钮 


这 里 不 允许 发 给 下 级 这 里 不 允许 发 给 下 级 
13:58:02 触摸 动作 未 分 发 ， 技 钮 点 击 不 了 了 





11-6 “正常 布局 允许 分 发 事件 11-7 不 派发 布局 未 分 发 事件 
再 来 看 看 拦截 事件 的 自 定义 布局 代码 : 
public class InterceptLayout extends LinearLayout ( 
public InterceptLayout(Context context) f 
super(context); 
j 
public InterceptLayout( Context context, AttributeSet attrs) í 
super(context, attrs); 
j 
(@Override 
public boolean onlnterceptTouchEvent(MotionEvent ev) í 
if (mListener != null) í 
mListener.onIntercept(); 
h 
return true; // 一 般 容器 默认 返回 false (不 拦截 )， 不 过 滚动 视图 Scroll View 会 拦截 
; 
private InterceptListener mListener; 
public void setlnterceptListener(InterceptListener listener) í 


mListener = listener; 


上 

public static interface InterceptListener í 
public abstract void onIntercept(); 

b 


} 
活动 页 面 实现 的 onIntercept 方法 代码 如 下 : 
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public void onlntercept() í 
desc_yes = String.format("%s%s 触摸 动作 被 拦截 ， 按 钮 点 击 不 了 了 \m", desc yes, 
DateUtil.getNowTime()); 
tv intercept yes.setText(desc yes); 
} 
拦截 事件 的 处 理 效果 如 图 11-8 和 图 11-9 所 示 。 其 中 ， 图 11-8 的 上 面部 分 为 正常 布局 ， 
此 时 按钮 可 正常 响应 点 击 事件 ; 图 11-9 的 下 面部 分 为 拦截 布局 ， 此 时 按钮 不 会 响应 点 击 事件 ， 
取而代之 的 是 执行 拦截 布局 的 onIntercept 方法 。 











这 里 不 拦截 下 级 的 事件 这 里 不 拦截 下 级 的 事件 
13:56:22 您 点 击 了 按钮 13:56:22 您 点 击 了 按钮 


这 里 拦截 了 下 级 的 事件 这 里 拦截 了 下 级 的 事件 
13:57:05 触摸 动作 被 拦截 ， 按 钮 点 击 不 了 了 





图 11-8 正常 布局 不 拦截 事件 图 11-9 拦截 布局 拦截 事件 
11.22 手势 事件 处 理 MotionEvent 
dispatchTouchEvent、onInterceptTouchEvent 和 onTouchEvent 的 输入 参数 都 是 手势 事件 
MotionEvent， 其 中 包含 触摸 动作 的 所 有 信息 ， 各 种 手势 操作 都 得 到 MotionEvent 中 获取 信息 
并 进行 判断 处 理 。 
下 面 是 MotionEvent 的 常用 方法 说 明 。 


e getAction: 获取 当前 的 动作 类 型 。 动 作 类 型 的 取 值 说 明 见 表 11-2。 
表 11-2 ”动作 类 型 的 取 值 说 阴 








MotionEvent 类 的 动作 类 型 说 明 
ACTION DOWN 按 下 动作 
ACTION_UP 提起 动作 





ACTION MOVE 

ACTION CANCEL 
ACTION OUTSIDE 
ACTION POINTER DOWN 
ACTION POINTER UP 
ACTION MASK 


移动 动作 

取消 动作 

移出 边界 动作 

第 二 个 点 的 按 下 动作 ， 用 于 多 点 触 控 的 判断 

第 二 个 点 的 提起 动作 ， 用 于 多 点 触 控 的 判断 

动作 掩 码 ， 与 原 动 作 类 型 进行 “与 ”(&) 操作 后 获得 多 点 触 控 信息 


e getEventTime: 获取 事件 时 间 ( 从 开机 到 现在 的 毫秒 数 ) 。 
e getX: 获取 在 控件 内 部 的 相对 横 坐 标 。 
e getY: 获取 在 控件 内 部 的 相对 纵 坐 标 。 
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getRawX: 获取 在 屏幕 上 的 绝对 横 坐 标 。 

getRawY: 获取 在 屏幕 上 的 绝对 纵 坐 标 。 

getPressure: 获取 触摸 的 压力 大 小 。 

getPointerCount: 获取 触 控 点 的 数量 ， 如 果 为 2 就 表示 有 两 个 手指 同时 按压 屏幕 。 如 果 触 
控 点 数目 大 于 1， 坐 标 相关 方法 就 可 输入 整 型 编号 ， 表 示 获 取 第 几 个 触 控 点 的 坐标 信息 。 


下 面 是 演示 单 点 触摸 的 页 面 代码 : 


public class TouchSingleActivity extends AppCompatActivity { 
private TextView tv_touch; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity touch single); 
tv touch = (TextView) find ViewById(R.id.tv touch); 

j 


@Override 
public boolean onTouchEvent(MotionEvent event) { 
int seconds = (int) (event.getEventTime() / 1000); // 从 开机 到 现在 的 毫秒 数 
int hour = seconds / 3600; 
int minute = seconds % 3600 / 60; 
int second = seconds % 60; 
Date date = new Date(event.getEventTime()); 
String desc = String.format(" 动 作 发 生 时 间 : 开机 距离 现在 %02d:%02d:%02d"， 
hour, minute, second); 
desc = String.format("%s\n 动作 名 称 是 : ", desc); 
int action = event.getAction(); 
if (action = event.ACTION DOWN){ 
desc = String.format("%s 14 F", desc); 
} else if (action — event.ACTION_MOVE) í 
desc = String.format("%s 移动 ", desc); 
) else if (action == event.ACTION UP) ( 
desc = String.format("%s 提起 ", desc); 
} else if (action — event. ACTION CANCEL) í 
desc = String.format("%s 取消 ", desc); 
; 
desc = String.format("%s\n 动作 发 生 位 置 是 : WRA WEERA", 
desc, event.getX(), event.get Y()); 
tv_touch.setText(desc); 
return super.onTouchEvent(event); 
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单 点 触摸 的 效果 如 图 11-10、 图 11-11、 图 11-12 所 示 。 其 中 ， 图 11-10 所 示 为 手势 按 下 时 
的 检测 界面 , 图 11-11 所 示 为 手势 移动 时 的 检测 界面 , 图 11-12 所 示 为 手势 提起 时 的 检测 界面 。 











动作 发 生 时 间 : 开机 距离 现在 00:23:52 Fases TERR 25:08 pria TERREN 25:11 
动作 名 称 是 : 按 下 动作 名 称 是 : 动作 名 称 是 : 
动作 发 生 位 置 是 : 横 坐 标 279.514740， 纵 坐 DEREDE”. 横 坐 标 299.949188 ， 纵 坐 AERE 横 坐 标 299.949188 ， 纵 坐 
标 698.318054 标 472.538544 标 472.538544 

图 11-10 手势 按 下 时 的 界面 图 11-11 手势 移动 时 的 界面 图 11-12 手势 提起 时 的 界面 


除了 单 点 触摸 ， 智 能 手机 还 普遍 支持 多 点 触 控 ， 即 响应 两 个 及 以 上 手指 同时 按压 屏幕 。 
多 点 触 控 可 用 于 操纵 图 像 的 缩放 与 旋转 操作 ， 以 及 需要 多 点 处 理 的 游戏 界面 。 
下 面 是 演示 多 点 触 控 的 页 面 代码 : 
public class TouchMultipleActivity extends AppCompatActivity í 
private Text View tv touch main; 


private TextView tv touch secondary; 
private boolean bSecondaryPressed = false; 


@Override 
protected void onCreate(Bundle savedInstanceState) í 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity touch multiple); 

tv touch main = (TextView) findViewById(R.id.tv touch main); 

tv touch secondary = (TextView) find ViewById(R.id.tv touch secondary); 


(a Override 
public boolean onTouchEvent(MotionEvent event) í 


int seconds = (int) (event.getEventTime() / 1000); 
int hour = seconds / 3600; 
int minute = seconds % 3600 / 60; 
int second = seconds % 60; 
Date date = new Date(event.getEventTime()); 
String desc main = String.format(" 主 要 动作 发 生 时 间 : 开机 距离 现在 %02d:%02d:%02d\n%s"， 
hour, minute, second, "主要 动作 名 称 是 : "); 
String desc secondary = ""; 
int action = event.getAction() & MotionEvenL. ACTION MASK; 
if (action = even. ACTION DOWN) í 
desc main = String.format("96s 按 下 ", desc main); 
} else if (action = event. ACTION MOVE) í 
desc main = String.format("96s 移动 ", desc. main); 
if (bSecondaryPressed = true) í 
desc secondary = String.format("%s 次 要 动作 名 称 是 : 移动 ", desc. secondary); 
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} else if (action — event.ACTION UP) í 
desc main = String.format("?6s 提起 ", desc. main); 
} else if (action = event. ACTION CANCEL) í 
desc main = String.format("?6s 取消 ", desc main); 
} else if (action = event. ACTION POINTER DOWN) í 
bSecondaryPressed = true; 
desc secondary = String.format("%s 次 要 动作 名 称 是 : 按 下 ", desc. secondary); 
} else if (action — event.ACTION POINTER UP) í 
bSecondaryPressed = false; 
desc secondary = String.format("%s 次 要 动作 名 称 是 : HE", desc secondary); 
desc main = String.format("%s 主要 动作 发 生 位 置 是 : RERA, AA Sof", 
desc main, event.getX(), event.getY()); 
tv touch main.setText(desc main); 
if (bSecondaryPressed—true || desc. secondary.length()70) í 
desc secondary = String.format("%s 次 要 动作 发 生 位 置 是 : WERA, WRAT", 
desc_secondary, event.getX(1), event.getY(1)); 
tv touch secondary.setText(desc secondary); 
J 


return super.onTouchE vent(event); 


} 


多 点 触 控 的 效果 如 图 11-13 和 图 11-14 所 示 。 其 中 ， 图 11-13 所 示 为 两 个 手指 一 起 按 下 时 
的 检测 界面 ， 图 11-14 所 示 为 两 个 手指 一 齐 提起 时 的 检测 界面 。 


主要 动作 发 生 时 间 : 开机 距离 现在 39:40:01 el 开机 距离 现在 39:41:41 
称 是 : dE 要 动作 : 


主要 人 横 坐 标 460.360626， 纵 


: 提起 
次 要 动作 发 生 位 置 是 : 横 坐标 220.693481， 纵 
坐标 635.503540 坐标 766.401245 











图 11-13 两 个 手指 一 齐 按 下 时 的 界面 图 11-14 两 个 手指 一 齐 提起 时 的 界面 
11.23 手写 签名 


为 了 加 深 对 触摸 事件 的 认识 ， 接 下 来 我 们 通过 实现 一 个 手写 签名 控件 进一步 理解 手势 处 
理 的 应 用 场合 。 

手写 签名 的 原理 是 把 手机 屏幕 当 作画 板 ， 把 用 户 手指 当 作画 笔 ， 手 指 在 屏幕 上 划 来 划 去 ， 
屏幕 就 会 显示 手指 的 移动 轨迹 , 就 像 画 笔 在 画板 上 写字 一 样 。 实 现 手写 签名 需要 结合 绘图 的 路 
f$ LR Path， 在 有 按 下 动作 时 调用 Path 对 象 的 moveTo 方法 ， 将 路 径 起 始点 移 到 触摸 点 ;在 
有 移动 操作 时 调用 Path 对 象 的 quadTo 方法 , 将 记录 本 次 触摸 点 与 上 次 触摸 点 之 间 的 路 径 ; 在 
有 移动 操作 与 提起 动作 时 调用 Canvas 对 象 的 drawPath 方法 ， 将 本 次 触摸 轨迹 绘制 在 画布 上 。 
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手写 签名 控件 的 自 定义 代码 主要 片段 如 下 : 


@Override 
protected void onDraw(Canvas canvas) { 
super.onDraw(canvas); 
canvas.drawBitmap(cachebBitmap, 0, 0, null); 
canvas.drawPath(path, paint); // 这 个 是 需要 的 ， 最 近 一 次 路 径 保存 在 这 里 


private float mLastX, mLastY; 
@Override 
public boolean onTouchEvent(MotionEvent event) { 
switch (event.getAction()) { 
case MotionEvent.ACTION_DOWN: 
path.moveTo(event.getX(), event.getY()); 
pos. firstX = event.getX(); 
pos.firstY = event.getY(); 
break; 
case MotionEvent.ACTION MOVE: 
path.quadTo(mLastX, mLastY, event.getX(), event.getY()); 
pos.nextX — event.getX(); 
pos.nextY — event.getY(); 
pathArray.add(pos); 
pos = new PathPosition(); 
pos.firstX = event.getX(); 
pos.first Y — event.getY(); 
break; 
case MotionEvent. ACTION UP: 
cacheCanvas.drawPath(path, paint); 
path.reset(); 
break; 
; 
mLastX = event.getX(); 
mLastY = event.getY(); 
invalidate(); 
return true; 


j 


手写 签名 的 效果 如 图 11-15 和 图 11-16 所 示 。 其中, 图 11-05 所 示 为 写 到 一 半 的 签名 界面 ， 
图 11-16 所 示 为 签名 完成 的 界面 。 








Android Studio FERK: MEEME] App 上 线 














开始 签名 — mE mE 。 ”结束 签名 开始 签名 EE mE SREZ 
PETE A Hn 

AN AS 

图 11-15 ”签名 一 半 的 界面 图 11-16 ”签名 完成 的 界面 


113 “手势 检测 


本 节 介 绍 常见 手势 的 检测 与 使 用 ， 首 先 说 明 手 势 检 测 器 的 原理 与 具体 用 法 ; 然后 阐述 飞 
掠 视图 的 基本 用 法 , 利用 飞 掠 视图 实现 简单 的 横幅 轮 播 ; 最 后 结合 手势 检测 器 与 飞 掠 视图 说 明 
如 何 通过 手势 检测 器 控制 横幅 轮 播 的 翻 页 动作 。 


11.3.1 手势 检测 器 GestureDetector 





由 于 触摸 事件 的 检测 与 识别 比较 烦琐 ， 因 此 Android 提供 了 手势 检测 器 GestureDetector 
帮助 开发 者 识别 手势 。 利 用 GestureDetector 可 以 自动 辨别 常用 的 几 个 手势 事件 ， 如 点 击 、 长 
按 、 滑 动 等 ， 从 而 使 开发 者 专注 于 业务 逻辑 ， 不 必 在 手势 的 行为 判断 上 绞 尽 脑汁 。 

下 面 是 GestureDetector 的 常用 方法 。 

e 构造 函数 : 注册 手势 监听 器 OnGestureListener， 该 监听 器 提供 了 若干 种 手势 方法 ， 需 要 

重 写 以 接管 对 应 的 事件 处 理 。 手 势 方法 说 明 如 下 : 


> onDown: 在 用 户 按 下 时 触发 。 

> onShowPress: 已 按 下 但 还 未 滑动 或 松 开 时 触发 ， 通 常用 于 按 下 状态 时 的 高 亮 显示 。 

> onSingleTapUp: 在 用 户 轻 点 一 下 弹 起 时 触发 ， 通 常用 于 点 击 事件 。 按 下 时 间 在 0.5 秒 内 为 
点 击 。 

> onScroll: 在 用 户 滑动 过 程 中 触发 。 

> onLongPress: 在 用 户 长 按时 触发 ， 通 常用 于 长 按 事件 。 按 下 时 间 超 过 0.5 秒 为 长 按 。 

> onFling: 在 用 户 飞 快 地 滑 出 一 段 距离 时 触发 ， 通 常用 于 翻 页 事件 。 该 方法 的 前 两 个 参数 
为 滑动 开始 和 结束 时 的 事件 信息 , 后 面 两 个 参数 分 别 为 滑动 操作 在 横 坐 标 上 的 滑动 速率 和 
在 纵 坐标 上 的 滑动 速率 。 

上 述 手 势 方法 有 部 分 需要 返回 布尔 值 ， 返 回 true 表示 该 手势 已 经 被 处 理 了 ， 其 他 人 不 需 

要 再 做 无 用 功 ; 返回 false 表示 该 手势 没 被 处 理 ， 留 给 其 他 人 处 理 。 

e onTouchEvent 由 手势 检测 器 接管 对 应 视图 的 触摸 事件 。 
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下 面 是 使 用 OnGestureListener 的 代码 : 


public class GestureDetectorActivity extends AppCompatActivity í 
private TextView tv gesture; 
private GestureDetector mGesture; 
private String desc = ""; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity gesture detector); 
tv gesture = (TextView) findViewById(R.id.tv gesture); 
mGesture = new GestureDetector(this, new MyGestureListener()); 


public boolean dispatchTouchEvent(MotionE vent event) í 
mGesture.onTouchE vent(event); 
return true; 


final class MyGestureListener implements GestureDetector.OnGestureListener í 
@Override 
public final boolean onDown(MotionEvent event) { 
return true; //onDown 的 返回 值 没有 作用 ， 不 影响 其 他 手势 的 处 理 


(@Override 
public final boolean onFling(MotionEvent el, MotionEvent e2, float velocityX, float velocityY) í 
float offsetX = el.getX() - e2.getX(); 
float offsetY — el.getY() - e2.getY(); 
if (Math.abs(offsetX) > Math.abs(offsetY)) í 
if (offsetX > 0) { 
desc = String.format("%s%s 您 向 左 滑动 了 一 下 \n", desc, DateUtil.getNowTime()); 
) else í 
desc = String.format("%s%s 您 向 右 滑 动 了 一 下 \n", desc, DateUtil.getNowTime()); 
1 
} else í 
if (offsetY > 0) { 
desc = String.format("%s%s 您 向 上 滑动 了 一 下 \n", desc, DateUtil.getNowTime()); 
}else{ 
desc = String.format("%s%s 您 向 下 滑动 了 一 下 \n", desc, DateUtil.getNowTime0); 
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tv gesture.setText(desc); 
return true; 

J 

@Override 


public final void onLongPress(MotionEvent event) { 
desc = String. format("%s%s 您 长 按 了 一 下 下 \n", desc, DateUtil.getNowTime()); 
tv gesture.setText(desc); 

; 


@Override 
public final boolean onScroll(MotionEvent el, MotionEvent e2, float distanceX, float distanceY) í 
return false; 


j 


@Override 
public final void onShowPress(MotionEvent event) í 
j 


(@Override 

public boolean onSingleTapUp(MotionEvent event) í 
desc = String.format("%s%s 您 轻 轻 点 了 一 下 \n", desc, DateUtil.getNowTime()); 
tv. gesture.setText(desc); 
return true; /返回 true 表示 已 经 处 理 了 ， 其 他 地 方 不 要 再 处 理 这 个 手势 


j 
手势 检测 器 的 使 用 效果 如 图 11-17 所 示 ， 可 以 发 现 检测 到 的 手势 包括 点 击 、 长 按 、 上 下 左 
右 滑动 等 。 





14:11:26 您 向 左 滑动 了 一 下 
14:11:29 您 向 右 滑动 了 一 下 
14:11:31 您 向 上 滑动 了 一 下 
14:11:33 您 向 下 滑动 了 一 下 
14:11:38 您 轻 轻 点 了 一 下 
14:11:41 您 长 按 了 一 下 下 





图 11-17 手势 检测 器 的 检测 结果 
11.3.2 KRME ViewFlipper 


手机 屏幕 尺寸 不 大 ， 为 了 在 有 限 空间 中 展示 尽 可 能 多 的 信息 ，Android 设计 了 多 种 方式 显 
示 超 出 屏幕 尺寸 的 界面 ， 包 括 上 下 滚动 、 左 右 滑动 等 。 飞 掠 视图 ViewFlipper 的 层次 翻动 就 是 
其 中 一 项 技术 。 与 ViewPager 相 比 ， 两 者 都 是 一 系列 类 似 视图 的 组 合 ，ViewFlipper 更 像 是 视 
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图 的 立体 排列 (如 现实 生活 中 的 书籍 ) ， 从 上 往 下 翻 页 ，ViewPager 更 像 是 一 幅 长 长 的 平面 画 
卷 ， 从 左 往 右 翻 页 。 
下 面 是 ViewFlipper 的 常用 方法 。 


setFlipInterval: 设置 每 次 翻 页 的 时 间 间 隔 。 单 位 毫秒 。 
setAutoStart: 设置 是 否 自动 开始 翻 页 。 为 true 表示 自动 开始 。 
startFlipping: 开始 翻 页 。 

stopFlipping: 停止 翻 页 。 

isFlipping: 判断 当前 是 否 正在 翻 页 。 

showNext: 显示 下 一 个 视图 。 

showPrevious: 显示 上 一 个 视图 。 

setDisplayedChild: 设置 当前 展示 第 几 个 视图 。 
getDisplayedChild: 获取 当前 展示 的 是 第 几 个 视图 。 
setInAnimation: 设置 视图 的 移入 动画 。 
getlnAnimation: 获取 移入 动画 的 动画 对 象 。 
setOutAnimation: 设置 视图 的 移出 动画 。 
getOutAnimation: 获取 移出 动画 的 动画 对 象 。 


下 面 是 利用 ViewFlipper 实现 简单 横幅 轮 播 的 代码 : 


public class ViewFlipperActivity extends AppCompatActivity implements OnClickListener { 
private Button btn_control_flipper; 
private RelativeLayout rl_content; 


private ViewFlipper vf. content; 
private RadioGroup rg indicator; 
private int dip 15; 

private boolean bPlay — true; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity view flipper); 
btn control flipper = (Button) find ViewById(R.id.btn control flipper); 
rl content = (RelativeLayout) findViewById(R.id.rl content); 
vf. content = (ViewFlipper) findViewById(R.id.vf content); 
rg indicator = (RadioGroup) find ViewById(R.id.rg indicator); 
btn control flipper.setOnClickListener(this); 
findViewByld(R.id.btn pre flipper).setOnClickListener(this); 
findViewByld(R.id.btn next flipper).setOnClickListener(this); 
initFlipper(); 

È 


private void initFlipper() { 
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LayoutParams params = (LayoutParams) rl_content.getLayoutParams(); 
params.height = (int) (DisplayUtil.getSreenWidth(this) * 250f/ 640f); 
rl content.setLayoutParams(params); 
ArrayList<Integer imageList = new ArrayList-Integer^(); 
imageList.add(Integer.valueOf(R.drawable.banner 1)); 
imageList.add(Integer.valueOf(R.drawable.banner 2)); 
imageList.add(Integer.valueOf(R.drawable.banner 3)); 
imageList.add(Integer.valueOf(R.drawable.banner 4)); 
imageList.add(Integer.valueOf(R.drawable.banner 5)); 
for (int i = 0; i < imageList.size(); i++) í 
Integer imageID = ((Integer) imageList.get(i)).int Value(); 
ImageView iv item = new ImageView(this); 
iv item.setLayoutParams(new LayoutParams( 
LayoutParams. MATCH PARENT, LayoutParams.MATCH PARENT)); 
iv item.setScaleType(ImageView.ScaleType.FIT XY); 
iv item.setImageResource(imageID); 
vf content.addView(iv item); 
j 
dip_15 = Utils.dip2px(this, 15); 
for (int i = 0; i < imageList.size(); i+) Í 
RadioButton radio = new RadioButton(this); 
radio.setLayoutParams(new RadioGroup.LayoutParams(dip 15,dip 15)); 
radio.setGravity(Gravity.CENTER); 
radio.setButtonDrawable(R.drawable.indicator selector); 
rg indicator.addView(radio); 
j 
vf content.setDisplayedChild(0); 
vf content.setAutoStart(true); 
mHandler.postDelayed(mRefresh, 200); 


@Override 
public void onClick(View v) { 
if (v.getld() == R.id.btn pre flipper) { 
vf content.showPrevious(); 
} else if (v.getId() = R.id.btn next flipper) í 
vf content.showNext(); 
} else if (v.getId() = R.id.btn control flipper) í 
bPlay = !bPlay; 
if (bPlay = true) í 
vf content.startFlipping(); 
btn control flipper.setText(" f£ F EL z) 91"); 
} else í 
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) 


vf content.stopFlipping(); 
btn control flipper.setText("JF 4 A zh fS Vi"); 


private Handler mHandler = new Handler); 
private Runnable mRefresh — new Runnable() ( 
@Override 
public void run() í 
int pos = vf_content.getDisplayedChild(); 
((RadioButton) rg_indicator.getChildAt(pos)).setChecked(true); 
mHandler.postDelayed(this, 200); 


j 


简单 横幅 轮 播 的 效果 如 图 11-18 和 图 11-19 所 示 。 其 中 , 图 11-18 所 示 为 开始 轮 播 的 界面 ， 
通过 按钮 控制 翻 到 上 一 页 、 翻 到 下 一 页 或 自动 进行 翻 页 ; 图 11-19 所 示 为 轮 播 到 第 4 张 图 片 时 
的 界面 ， 轮 播 间 隔 既 可 以 在 代码 中 调用 setFlipInterval 方法 设置 ， 又 可 以 直接 在 布局 文件 中 指 


定 flipInterval 属性 。 


event 


往 后 翻 页 停止 自动 翻 页 





图 11-18 ” 飞 掠 视图 开始 轮 播 图 11-19 飞 掠 视图 轮 播 到 第 4 张 
11.3.3 ”手势 控制 横幅 轮 播 


前 面 演示 简单 横幅 轮 播 时 ， 需 要 通过 按钮 控制 轮 播 动作 ， 非 常 不 便 。 接 下 来 我 们 尝试 结 
合 手势 检测 器 与 飞 掠 视图 实现 手势 控制 的 轮 播 效果 。 具 体 处 理 步 又 如 下 : 


ED 定义 一 个 手势 检测 器 的 对 象 ， 并 在 自 定义 视图 的 dispatchTouchEvent 方法 中 声明 本 视图 


的 触摸 事件 由 该 检测 器 接管 。 








E 实现 手势 监听 器 的 onFling 方法 ， 在 该 方法 内 部 判断 播放 上 一 页 还 是 播放 下 一 页 ， 简 单 
实现 只 需 判断 滑动 前 后 的 横 坐标 偏 移 是 否 超出 阔 值 ; 若 想 更 精确 地 校 验 ， 则 可 增加 检查 横 坐 标 上 的 滑 
动 速率 是 否 达标 ， 即 判断 velocityX 是 否 超出 阔 值 。 





E 做 一 个 简 
BR. 








定时 器 , 通过 获取 当前 正在 播放 的 视图 编号 设置 下 方 指示 器 对 应 次 序 的 高 亮 
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下 面 是 手势 控制 横幅 轮 播 的 自 定义 布局 代码 : 


public class BannerFlipper extends RelativeLayout í 
private static final String TAG = "BannerFlipper"; 
private Context mContext; 
private ViewFlipper mFlipper; 
private RadioGroup mGroup; 
private LayoutInflater mlnflater; 
private int dip_15; 
private GestureDetector mGesture; 
private float mFlipGap = 20f; 


public BannerFlipper(Context context) í 
this(context, null); 


j 

public BannerFlipper(Context context, AttributeSet attrs) í 
super(context, attrs); 
mContext = context; 
init(); 


public void setImage(ArrayList-Integer^ imageList) í 

for (int i = 0; i < imageList.size(); i++) { 
Integer imageID = ((Integer) imageList.get(i)).int Value(); 
ImageView iv item = new ImageView(mContext); 
iv item.setLayoutParams(new LayoutParams( 

LayoutParams.MATCH PARENT, LayoutParams. MATCH PARENT)); 

iv item.setScaleType(ImageView.ScaleType.FIT XY); 
iv item.setImageResource(imageID); 
mFlipper.addView(iv item); 

j 

for (int i = 0; i < imageList.size(); i+) í 
RadioButton radio = new RadioButton(mContext); 
radio.setLayoutParams(new RadioGroup.LayoutParams(dip 15, dip 15)); 
radio.setGravity(Gravity. CENTER); 
radio.setButtonDrawable(R.drawable.indicator selector); 
mGroup.addView(radio); 

] 

mFlipper.setDisplayedChild(imageList.size() - 1); 

startFlip(); 








# 件 Sn 





private void init() í 
mlnflater = ((Activity) mContext).getLayoutInflater(); 
View view = mlnflater.inflate(R.layout.banner_flipper, null); 
mFlipper = (ViewFlipper) view.findViewById(R.id.banner_flipper); 
mGroup = (RadioGroup) view.find ViewById(R.id.rg indicator); 
addView(view); 
dip 15 — Utils.dip2px(mContext, 15); 
/ 该 手势 的 onSingleTapUp 事件 是 点 击 时 进入 广告 页 
mGesture = new GestureDetector(mContext, new BannerGestureListener()); 
mHandler.postDelayed(mRefresh, 200); 


public boolean dispatchTouchEvent(MotionEvent event) { 
mGesture.onTouchEvent(event); 
Teturn true; 


final class BannerGestureListener implements GestureDetector.OnGestureListener { 
@Override 
public final boolean onDown(MotionEvent event) { 
return true; 


@Override 
public final boolean onFling(MotionEvent el, MotionEvent e2, float velocityX, float velocityY) í 
if (el.getX() - e2.getX() > mFlipGap) í 


startFlip(); 
retum true; 
j 
if (el.getX() - e2.getX() < -mFlipGap) í 
backFlip(); 
retum true; 
Í 
return false; 
; 
(QOverride 
public final void onLongPress(MotionEvent event) í 
j 
@Override 


public final boolean onScroll(MotionEvent el, MotionEvent e2, float distanceX, float distanceY) í 
return false; 
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@Override 
public final void onShowPress(MotionEvent event) { 
j 


@Override 

public boolean onSingleTapUp(MotionEvent event) { 
int position = mFlipper.getDisplayedChild(); 
mListener.onBannerClick(position); 
return true; 


private void startFlip() í 
mFlipper.startFlipping(); 


mFlipper.showNext(); 

} 

private void backFlip() í 
mFlipper.startFlipping(); 
mFlipper.showPrevious(); 


private Handler mHandler = new Handler(); 
private Runnable mRefresh = new Runnable() í 
@Override 
public void run() { 
int pos = mFlipper.getDisplayedChild(); 
((RadioButton) mGroup.getChildAt(pos)).setChecked(true); 
mHandler.postDelayed(this, 200); 


h 
private BannerClickListener mListener; 


public void setOnBannerListener(BannerClickListener listener) í 
mListener = listener; 


public static interface BannerClickListener { 
public abstract void onBannerClick(int position); 
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手势 控制 横幅 轮 播 的 效果 如 图 11-20 和 图 11-21 所 示 。 其 中 ， 图 11-20 所 示 为 开始 轮 播 的 
界面 ， 这 里 没有 任何 按钮 ， 完 全 依靠 手势 的 滑动 控制 左 翻 还 是 右 翻 : 图 11-21 所 示 为 手势 从 右 
往 左 滑 过 后 的 界面 ， 从 右 往 左 滑 表示 翻 到 下 一 页 ， 所 以 当前 界面 由 第 二 页 跳 到 第 三 页 。 








11-20 手势 横幅 开始 轮 播 图 11-21 手势 滑动 翻 到 下 一 页 


114 手势 冲突 处 理 


本 节 介 绍 手势 冲突 的 常见 处 理 办 法 ， 对 于 上 下 深 动 与 左右 滑动 的 冲突 ， 既 可 由 上 级 视图 
主动 判断 是 否 拦 截 , 又 可 由 下 级 视图 根据 情况 向 上 级 反馈 是 否 允 许 拦截 ; 对 于 内 部 滑动 与 翻 页 
滑动 的 冲突 ， 可 以 通过 限定 某 块 区 域 接管 特定 的 手势 实现 对 不 同 手势 的 区 分 处 理 。 


11.4.1 上 下 滚动 与 左右 滑动 的 冲突 处 理 


Android 控件 繁多 ， 人 允许 滚动 或 滑动 操作 的 视图 也 不 少 ， 比 如 滚动 视图 ScrollView、 翻 页 
视图 ViewPager 等 ， 如 果 开 发 者 要 自己 接管 手势 处 理 ， 像 上 一 节 手 势 控制 横幅 轮 播 那样 处 理 ， 
这 个 页 面 的 滑动 就 存在 重 登 的 情况 ， 即 很 可 能 造成 滑动 冲突 ， 系 统 响 应 了 A 视图 的 滑动 事件 ， 
就 顾 不 上 B 视图 的 滑动 事件 。 

举 个 例子 ， 某 电 商 App 的 主页 很 长 ， 内 部 采用 滚动 视图 ScrollView， 人 允许 上 下 滚动 。 该 
页 面 中 央 有 一 个 手势 控制 的 横幅 轮 播 ， 如 图 11-22 所 示 。 用 户 在 Banner 上 左右 滑动 ， 试 图 查 
看 Banner 的 前 后 广告 ， 结 果 如 图 11-23 所 示 ， 翻 页 不 成 功 ， 整 个 页 面 反而 往 上 滚动 了 。 


招牌 惠 搬 新 家 啦 


小 积分 淘 优 惠 天 天 有 好 礼 
9== 


11-22 ”滚动 视图 中 的 横幅 轮 播 1-3 ” 翻 页 滑动 导致 上 下 滚动 


请 点 击 推介 图 片 
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即使 多 次 重复 试验 ， 仍 然 会 发 现 Banner 很 少 跟着 翻 页 ， 而 是 继续 上 下 滚动 。 因 为 Banner 
外 层 被 ScrollView 包 着 ， 系 统 检 测 到 用 户 手 势 的 一 撤 ， 上 级 领导 ScrollView 自作 主张 地 认为 
用 户 要 把 页 面 往 上 拉 ， 于 是 页 面 往 上 深 动 ， 完 全 没 考虑 这 一 撒 其 实 是 用 户 想 翻动 Banner, fH 
是 ScrollView 不 会 考虑 这 些 ， 因 为 没有 告诉 它 超过 多 大 斜率 才 可 以 上 下 滚动 ; 既然 没有 通知 ， 
ScrollView 只 要 发 现 手势 事件 前 后 的 纵 坐 标 发 生变 化 ， 就 会 一 律 进行 上 下 滚动 处 理 。 

要 解决 这 个 滑动 冲突 ,关键 在 于 提供 某 种 方式 通知 ScrollView， 告 诉 它 什么 时 候 可 以 上 下 
滚动 ， 什 么 时 候 不 能 上 下 滚动 。 这 个 通知 方式 主要 有 两 种 ， 一 种 是 上 级 主动 下 乡 体察 民情 ， 即 
由 滚动 视图 判断 滚动 规则 并 决定 是 否 拦截 手势 ; 另 一 种 是 下 级 向 上 反映 民意 , 即 由 下 级 视图 告 
诉 滚动 视图 是 否 拦截 手势 。 下 面 分 别 介绍 这 两 种 处 理 方 式 。 


1. 由 滚动 视图 判断 滚动 规则 


前 两 节 提 到 , 容器 类 视图 可 以 重 写 onInterceptTouchEvent 方法 , 根据 条 件 判 断 结果 决定 是 
否 拦截 发 给 下 级 的 手势 .我们 可 以 自 定义 一 个 滚动 视图 , 在 onInterceptTouchEvent 方法 中 判断 
本 次 手势 的 横 坐 标 与 纵 坐 标 ， 如 果 纵 坐标 的 仿 移 大 于 横 坐 标的 偏 移 ， 此 时 就 是 垂直 滚动 ,应 拦 
截 手 势 并 交 给 自身 进行 上 下 滚动 ; 否则 表示 此 时 为 水 平 滚动 ,不 应 拦截 手势 ,而 是 让 下 级 视图 
处 理 左 右 滑动 事件 。 
下 面 的 代码 用 于 演示 自 定 义 滚 动 视 图 拦截 垂直 滚动 、 同 时 放 过 水 平 滚动 的 功能 。 
public class CustomScroll View extends ScrollView í 
private float mOffsetX, mOffsetY; 
private float mLastPosX, mLastPosY; 








public CustomScroll View(Context context) í 
this(context, null); 


j 


public CustomScroll View(Context context, AttributeSet attr) { 
super(context, attr); 


j 


@Override 
public boolean onInterceptTouchEvent(MotionEvent event) í 
boolean result — false; 
switch (event.getAction()) í 
case MotionEvenL. ACTION DOWN: 
mOflsetX = 0.0F; 
moOffsetY = 0.0F; 
mLastPosX = event.getX(); 
mLastPosY = event.getY(); 
result = super.onInterceptTouchEvent(event); // false 传 给 子 控件 
break; 
default: 
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float thisPosX — event.getX(); 
float thisPosY — event.getY(); 
mOffsetX += Math.abs(thisPosX - mLastPosX); // x 轴 偏 差 
mOffsetY += Math.abs(thisPosY - m LastPosY); // y 轴 偏 差 
mLastPosX = thisPosX; 
mLastPosY = thisPosY; 
if(mOffsetX < 3 && mOffsetY < 3) ( 
result = false; // false 传 给 子 控件 〈 exitii h) 
) else if (mOffsetX < mOffsetY) { 
result = true; // true 不 传 给 子 控件 (垂直 滑动 ) 
} else í 
result = false; // false 传 给 子 控件 


接着 在 XML 布局 文件 中 把 ScrollView 节点 改 
为 自 定义 滚动 视图 的 完整 路 径 名 称 〈( 如 
com.example.event.widget.CustomScrollView) , Œ 
新 运行 App 后 查看 横幅 轮 播 ， 手 势 滑动 效果 如 图 
11-24 所 示 。 此 时 翻 页 成 功 , 且 整 个 页 面 固定 不 动 ， 
未 发 生 上 下 滚动 的 情况 。 

2. 下 级 视图 告诉 滚动 视图 能 否 拦截 手势 


目前 的 案例 中 ，ScrollView 下 面具 有 Banner 
-个 淘气 鬼 ， 所 以 允许 单独 给 它 开 小 灶 。 在 实际 场 图 11-24 翻 页 滑动 未 造成 上 下 滚动 
合 中 ， 往 往 有 多 个 调皮 鬼 ， 一 个 要 吃 苹果 ， 另 一 个 要 吃香 蕴 ， 倘 若 都 要 ScrollView 帮忙 ， 那 
可 真是 众 口 难 调 ， 忙 都 忙 不 过 来 了 。 不 如 弄 个 水 果 篮 ， 让 这 些小 屁 孩 自己 去 拿 ， 要 吃 苹果 的 就 
拿 苹果 ， 要 吃香 蕉 的 就 拿 香花 ， 如 此 皆大欢喜 ， 再 也 不 用 大 人 劳 心 劳 力 了 。 
具体 到 代码 的 实现 , 是 调用 requestDisallowInterceptTouchEvent 方法 , 该 方法 的 参数 为 true 
时 ， 表 示 禁 止 上 级 拦截 触摸 事件 。 至 于 何 时 调用 该 方法 ， 当 然 是 在 检测 到 滑动 前 后 的 横 坐 标 偏 
移 大 于 纵 坐 标 偏 移 了 。 对 于 Banner 采用 手势 监听 器 的 情况 ， 可 重 写 监听 器 的 onScroll 方法 ， 
在 该 方法 中 加 入 坐标 偏 移 的 判断 ， 代 码 如 下 : 
public final boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY){ 
/ 如 果 外 层 是 普通 的 SecrollView， 此 处 就 不 允许 父 容器 的 拦截 动作 
if (Math.abs(distanceY) < Math abs(distanceX)) í 
BannerFlipper.this.getParent().requestDisallowInterceptTouchEvent(true); 
retum true; 
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} else { 
retum false; 
b 
ji 
修改 后 的 手势 滑动 效果 如 图 11-24 所 示 。 左 右 滑动 能 够 正常 翻 页 ， 整 个 页 面 也 不 容易 上 下 
滚动 了 。 


11.4.2 ”内 部 滑动 与 翻 页 滑动 的 冲突 处 理 


在 前 面 的 手势 冲突 中 ，ScerollView 是 上 级 视图 ， 有 时 也 是 下 级 视图 ， 比 如 页 面 采 用 
ViewPager 布局 ， 每 个 Fragment 之 间 是 左右 滑动 的 关系 ， 每 个 Fragment 都 可 以 拥有 自己 的 
ScrollView。 如 此 一 来 ， 在 左右 滑动 时 ，ScrollView 反而 变 成 ViewPager 的 下 级 ， 这 样 前 面 的 
冲突 处 理 办 法 不 能 奏效 了 ， 只 能 另 想 办 法 。 

自 定义 一 个 基于 ViewPager 的 翻 页 视图 是 一 种 思路 ; 另 一 种 思路 可 借鉴 Android 自 带 的 抽 
Ju li) DrawerLayout， 该 布局 视图 允许 左右 滑动 ， 在 滑动 时 会 拉 出 侧面 的 抽 居 面板 ， 常 用 于 
实现 侧 滑 菜单 。 抽 居 布 局 与 翻 页 视图 在 滑动 方面 有 区 别 ， 翻 页 视图 在 内 部 的 任何 位 置 均 可 触发 
滑动 事件 ， 而 抽 居 布局 只 在 屏幕 两 侧 边缘 才 会 触发 滑动 事件 。 

举 个 实际 应 用 的 例子 ， 微 信 的 聊天 窗口 是 上 下 深 动 的 ， 在 主 窗口 的 大 部 分 区 域 触摸 都 是 
上 下 滚动 窗口 , 若 在 窗口 左 侧 边 缘 按 下 再 右 拉 ， 则 可 看 到 左边 拉 出 了 消息 关注 页 面 。 限 定 某 块 
区 域 接管 特定 的 手势 是 处 理 滑动 冲突 的 另 一 种 行 之 有 效 的 方法 。 

既然 提 到 了 抽 居 布局 ， 不 妨 稍 微 了 解 一 下 。 下 面 是 DrawerLayout 的 常用 方法 说 明 。 


e setDrawerShadow: 设置 主页 面 的 渐变 阴影 图 形 。 
e addDrawerListener: 添加 抽 居 面板 的 拉 出 监听 器 . 需 实现 监听 器 DrawerListener 的 4 个 方法 。 


> onDrawerSlide: 抽 导 面板 滑动 时 触发 。 

> onDrawerOpened: 抽 层 面板 打开 时 触发 。 

> onDrawerClosed: 抽 居 面板 关闭 时 触发 。 

> onDrawerStateChanged: 抽 层 面板 的 状态 发 生变 化 时 触发 。 


removeDrawerListener: 移 除 抽 层 面板 的 拉 出 监听 器 。 
closeDrawers: 关闭 所 有 抽 居 面板 。 

openDrawer: 打开 指定 抽 层 面板 。 

closeDrawer: 关闭 指定 抽 层 面板 。 

isDrawerOpen: 判断 指定 抽 层 面板 是 否 打 开 。 


抽 层 布局 不 但 可 以 拉 出 左 侧 抽 居 面板 ， 而 且 可 以 拉 出 右 侧 抽 居 面板 。 左 侧面 板 与 右 侧 面 
板 的 区 别 在 于 : 左 侧 面板 在 布局 文件 中 的 layout. gravity 属性 为 left, 而 右 侧面 板 在 布局 文件 中 
的 layout_gravity 属性 为 right。 

下 面 是 使 用 DrawerLayout 的 布局 文件 : 
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<android.support.v4.widget.DrawerLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:id="(@+id/dl_layout" 
android:layout width="match parent" 
android:layout height-"match parent" > 


«LinearLayout 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:orientation-" vertical" > 


*LinearLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" 
android:orientation-"horizontal" > 


«Button 
android:id-"(g)*id/btn drawer left" 
android:layout width-"Odp" 
android:layout height-"wrap content" 
android:layout weight-" 1" 
android:gravity-"center" 
android:text=" 打 开 左边 侧 滑 " 
android:textColor="(@color/black" 
android:textSize-"20sp" /> 


<Button 

android:id="@+id/btn_drawer_right" 
android:layout_width="0dp" 
android:layout_height="wrap_content" 
android:layout weight-" 1" 
android:gravity-"center" 
android:text=" 打 开 右 边 侧 滑 " 
android:textColor="(@color/black" 
android:textSize-"20sp" > 

</LinearLayout> 


<TextView 
android:id="(@+id/tv_drawer center" 
android:layout width="match parent" 
android:layout height="0dp" 
android:layout weight-"1" 
android:gravity-"top|center" 
android:paddingTop-"30dp" 
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android:text=" 这 里 是 首页 " 

android:textColor="(@color/black" 

android:textSize="20sp" /> 
</LinearLayout> 


<ListView 
android:id="(@+id/lv_drawer_left" 
android:layout_width="150dp" 
android:layout height-"match parent" 
android:layout gravity-"left" 
android:background-"?ffdd99" /> 


«ListView 
android:id-"(a)*id/lv drawer right" 
android:layout width-"150dp" 
android:layout height-"match parent" 
android:layout gravity-"right" 
android:background-"499ffdd" /> 
«/android.support.v4.widget. DrawerLayout^ 
上 述 布局 文件 对 应 的 页 面 代码 如 下 : 
public class DrawerLayoutActivity extends AppCompatActivity implements OnClickListener { 
private final static String TAG = "DrawerLayoutActivity"; 
private DrawerLayout dl layout; 
private Button btn drawer left; 
private Button btn. drawer right; 
private TextView tv drawer center; 
private ListView lv. drawer left; 
private ListView lv drawer right; 
private String[] titleAmay = ( "首页 ", "新 闻 ", "娱乐 ", "博客 ", "论坛 " }; 
private String[] settingArray = ( "我 的 ", "设置 ", "关于 " y; 


(@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity drawer layout); 
dl layout = (DrawerLayout) findViewById(R.id.dl layout); 
dl layout.addDrawerListener(new SlidingListener()); 
btn drawer left = (Button) findViewById(R.id.btn drawer left); 
btn drawer right — (Button) findViewById(R.id.btn drawer right); 
tv drawer center = (TextView) findViewById(R.id.tv drawer center); 
btn drawer left.setOnClickListener(this); 
btn drawer right.setOnClickListener(this); 
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lv drawer left = (ListView) findViewById(R.id.|v drawer left); 

ArrayAdapter-String- left adapter = new ArrayAdapter-String(this, 
R.layoutitem select, titleArray); 

lv drawer left.setAdapter(left adapter); 

lv drawer left.setOnItemClickListener(new LeftListListener()); 

lv drawer right = (ListView) findViewById(R.id.lv drawer right); 

ArrayAdapter-String» right adapter = new ArrayAdapter-String-(this, 
R.layout.item select, settingArray); 

lv drawer right.setAdapter(right adapter); 

lv drawer right.setOnItemClickListener(new RightListListener()); 


(a Override 
public void onClick(View v) í 
if (v.getId() == R.id.btn drawer left) í 
if(dl layout.isDrawerOpen(lv drawer left)) í 
dl layout.closeDrawer(lv drawer left); 
1 else í 
dl_layout.openDrawer(Iv_drawer_left); 
1 
} else if (v.getld() = R.id.btn drawer right) í 
if(dl layout.isDrawerOpen(lv drawer right)) ( 
dl layout.closeDrawer(lv drawer right); 
) else { 
dl layout.openDrawer(lv drawer right); 


private class LefiListListener implements OnItemClickListener í 
@Override 
public void onltemClick(AdapterView<?> parent, View view, int position, long id) í 
String text = titleArray[position]: 
tv_drawer_center.setText(" 这 里 是 " + text + "页 面 "); 
dl layout.closeDrawers(); 


private class RightListListener implements OnItemClickListener í 
(QOverride 
public void onItemClick(AdapterView-?- parent, View view, int position, long id) í 
String text = settingArray [position |; 
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tv drawer center.set Text(" 3X I Æ" + text + "页 面 "); 
dl layout.closeDrawers(); 


h 


private class SlidingListener implements DrawerListener í 
@Override 
public void onDrawerSlide(View paramView, float paramFloat) { 
$ 


@Override 
public void onDrawerOpened(View paramView) { 
if (paramView.getld() == R.id.lv_drawer left) í 
btn_drawer_left.setText(" 关 闭 左 边 侧 滑 "); 
) else ( 
btn drawer rightsetText(" 关 闭 右边 侧 滑 "); 
j 
j 


@Override 
public void onDrawerClosed(View paramView) { 
if (paramView.getId() == R.id.lv_drawer left) í 
btn drawer leftsetText(" 打 开 左 边 侧 滑 "); 
) else í 
btn drawer rightsetText(" 打 开 右边 侧 滑 "); 
j 
J 


@Override 
public void onDrawerStateChanged(int paramlnt) í 
; 


j 


抽 居 布局 的 展示 效果 如 图 11-25. Ed 11-26. Fd 11-27 所 示 。 其 中 ， 图 11-25 所 示 为 初始 页 
面 ， 图 11-26 所 示 为 在 左 侧 边缘 拉 出 左边 侧 滑 菜单 的 界面 ， 图 11-27 所 示 为 在 右 侧 边缘 拉 出 右 
边 侧 滑 菜单 的 界面 。 


打开 左边 侧 滑 打开 右边 侧 滑 


这 里 是 首页 





图 11-25 ”演示 抽 导 布局 的 的 初始 界面 
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首页 我 的 
新 闻 设置 
娱乐 关于 
博客 
论坛 


图 11-26 ” 左 侧 边缘 拉 出 侧 滑 菜单 图 11-27. 右 侧 边缘 拉 出 侧 滑 菜单 





11.5 KRMH: 抠 图 神器 一 一 美 图 变 变 


程序 员 通 常 是 闽 骚 的 宅男 ， 对 技术 的 钻研 孜孜 不 倦 ， 不 过 一 味 地 追求 技术 深度 ， 不 见得 
就 能 登 上 六 峰 。 壁 如 智能 手机 行业 ， 以 技术 制胜 的 华为 和 小 米 ， 销 量 反 而 不 敌 OPPO 和 vivos 
究 其 原因 ， 多 半 是 后 者 认真 对 待 用 户 需求 ， 从 用 户 体验 的 痛 点 下 手 ， 推 出 了 自拍 美 颜 等 手机 ， 
由 此 收获 了 大 批 客户 。 本 章 的 实战 项 目 不 求 技术 有 多 广 、 多 深 ， 只 求 有 没有 用 、 好 不 好 用 。 所 
谓 抠 图 神器 ， 就 是 从 一 幅 图 片 中 抠 出 用 户 想 要 的 某 块 区 域 。 就 像 在 花 店 里 卖 花 ， 先 适当 修剪 花 
束 ， 再 配 上 一 些 包 装 ， 顿 时 看 起 来 美美 叶 ， 不 悉 用 户 不 喜欢 。 


11.5.1 


这 里 说 的 美 图 变 变 ， 其 实 就 是 一 个 抠 图 工具 ， 通 过 对 图 像 
进行 平移 、 缩 放 、 旋 转 等 操作 ， 把 图 像 的 某 个 区 域 抠 下 来 。 图 
11-28 所 示 为 美 图 变 变 的 效果 图 , 中 间 高 亮 部 分 为 待 抠 区 域 , 西 
湖 后 面 的 雷 峰 塔 太 小 了 ， 现 在 准备 把 雷 峰 塔 先 拉 近 再 放大 ， 然 
后 抠 出 来 。 

这 个 效果 图 的 界面 很 简洁 ， 主 界面 没有 任何 控制 按钮 ， 完 
全 靠 手 势 操作 。 实 现 的 手势 处 理 有 以 下 6 种 。 


设计 思 


event 


长 按 手势: 在 页 面 任何 一 处 长 按 0.5 秒 以 上 ， 即 可 触发 攻 
按 事件 ， 弹 出 文件 菜单 后 选择 打开 图 片 成 保存 图 片 。 
移动 高 亮 区 域 的 手势 : 点 击 高 亮 区 域内 部 ， 再 滑动 手势 ， 
即 可 将 高 亮 区 域 拖 虹 至 指定 位 置 。 

调整 高 亮 区 域 边 界 的 手势 : 点 击 高 亮 区 域 边界 ， 再 滑动 
手势 ， 即 可 将 边界 拉动 至 指定 位 置 。 
移动 图 片 的 手势 : 点 击 高 亮 区 域外 部 ( 阴影 部 分 ) ， 然 EIS 美 图 变 变 的 抠 图 效果 
后 滑动 手势 ， 即 可 将 整 张 图 片 拖 虚 至 指定 位 置 。 

缩放 图 片 的 手势 :两 只 手指 同时 按压 屏幕 ， 然 后 一 起 往 中 心 点 接近 或 远离 ， 即 可 实现 图 
片 的 缩小 和 放大 操作 . 
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e° 旋转 图 片 的 手势 : 两 只 手指 同时 按压 屏幕 ， 然 后 围绕 中 心 点 一 起 顺 时 针 或 北 时 针 转 动 ， 
即 可 实现 图 片 的 旋转 操作 。 
长 按 和 移动 手势 的 判断 相对 简单 ， 根 据 按压 时 长 或 按压 坐标 就 能 判断 属于 哪 类 手势 。 缩 
放 与 旋转 手势 的 判断 相对 复杂 , 涉及 多 点 触 挖 和 三 角 函 数 相关 知识 , 主要 思路 是 : 记录 两 只 手 
指 移动 前 的 坐标 和 移动 后 的 坐标 , 总 共 4 个 坐标 点 , 然后 分 别 计算 移动 前 的 两 指 距离 和 移动 后 
的 两 指 距 离 , 判断 两 个 距离 的 差 是 否 大 于 两 指 移动 距离 之 和 的 二 分 之 根 号 二 倍 。 判断 结果 若是 
大 于 ， 则 表示 本 次 为 缩放 手势 ， 否 则 为 旋转 手势 ， 接 着 计算 缩放 比例 或 旋转 角度 即 可 。 


11.5.2 “小 知识 : 图 像 的 基本 加 工 


Android 上 的 图 形 使 用 Drawable 类 ， 位 图 管理 使 用 Bitmap 类 。Drawable 用 于 在 界面 上 展 
示 图 片 ，Bitmap 用 于 对 图 像 数 据 进行 加 工 操作 ， 图 像 加 工 操作 包括 平移 、 缩 放 、 旋 转 、 裁 前 
等 。 这 两 个 类 之 间 的 转换 通过 BitmapDrawable 完成 。 

其 中 ，Bitmap 转 Drawable 的 代码 如 下 : 


Drawable drawable = new BitmapDrawable(getResources(), bitmap); 
Drawable 转 Bitmap 的 代码 如 下 : 

Bitmap bitmap = ((BitmapDrawable)drawable).getBitmap(); 

下 面 是 Bitmap 的 常用 方法 说 明 。 

createBitmap: 从 源 图 像 中 裁剪 一 块 位 图 区 域 。 
createScaledBitmap: 根据 设 定 的 图 片 大 小 从 源 图 像 获 得 缩放 后 的 新 图 像 。 
compress: 根据 设 定 的 位 图 格式 与 压缩 质量 对 图 像 进行 压缩 。 
recycle: 回收 位 图 对 象 资源 。 
getByteCount: 获取 位 图 对 象 的 字 节 大 小 。 
getWidth: 获取 位 图 对 象 的 宽度 。 
getHeight: 获取 位 图 对 象 的 高 度 。 


了 解 这 些 方法 的 使 用 说 明 后 ， 就 可 以 实现 图 像 的 基本 加 工 操作 了 。 


CD 图 像 裁 前 : 调用 Bitmap 类 的 createBitmap 方法 时 ， 指 定 裁剪 图 像 的 上 、 下 、 左 、 右 
边界 即 可 。 
(2) 图 像 平 移 : 调用 Canvas 对 象 的 drawBitmap 时 ， 指 定 图 像 绘制 的 起 始点 位 置 即 可 。 
G) 图 像 缩 放 : 调用 Bitmap 类 的 createScaledBitmap 方法 时 ， 指 定 新 图 像 宽 和 高 的 数值 
即 可 。 
(4) 图 像 旋转 : 需要 借助 矩阵 工具 Matrix， 先 调用 Matrix 对 象 的 postRotate 方法 设置 旋 
转角 度 ， 再 根据 设置 好 的 矩阵 对 象 调用 createBitmap 方法 创建 旋转 图 像 ， 转 换代 码 如 下 : 
public static Bitmap getRotateBitmap(Bitmap b, float rotateDegree) { 
Matrix matrix = new Matrix(); 
matrix.postRotate((float) rotateDegree); 
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Bitmap rotaBitmap = Bitmap.createBitmap(b, 0, 0, b.getWidth(), b.getHeight(), matrix, false); 
return rotaBitmap; 
} 


图 像 变 换 的 效果 如 图 11-29, KI 11-30, K 11-31 所 示 。 其 中 ， 图 11-29 所 示 为 原始 的 图 像 
界面 , 图 11-30 所 示 为 放大 两 倍 后 的 图 像 界面 , 图 11-31 所 示 为 顺 时 针 旋转 90 度 后 的 图 像 界 面 。 


打开 图 片 文件 保存 图 片 文件 


缩放 比率 : 10 ”旋转 角度 :90 7 











图 11-29 变换 前 的 原始 图 像 图 11-30 ”放大 两 倍 后 的 图 像 图 11-31 旋转 90 度 后 的 图 像 
11.5.3 ”代码 示例 


编码 与 测试 方面 需要 注意 以 下 3 点 : 


(1) 对 图 片 文件 进行 打开 和 保存 操作 , 记得 为 AndroidManifestxml 添加 对 应 的 权限 配置 。 
<!--SD 卡 一 
<uses-permission android:name-"android.permission. WRITE EXTERNAL STORAGE" > 
«uses-permission android:name-"android.permission READ EXTERNAL STORAGE" /> 
«uses-permission android:name-"android.permission MOUNT UNMOUNT FILESYSTEMS" > 


(2) 长 按 弹 出 文件 菜单 ， 需 要 在 res/menu 目录 下 添加 菜单 布局 文件 menu. meitu.xml. 
(D 要 在 真 机 上 测试 实战 项 目 ， 因 为 模拟 器 不 支持 多 点 触 控 ， 只 有 真 机 才能 测试 手势 的 
缩放 与 旋转 操作 。 
测试 时 ， 首 先 在 实战 项 目的 界面 上 长 按 ， 弹 出 读 取 图 
片 文件 的 菜单 ， 如 图 11-32 所 示 。 
点 击 “ 打 开 图 片 ”， 打 开 待 加工 的 图 片 文件 ， 拖 动 原 
始 图 片 与 高 亮 区 域 ， 并 适当 放大 与 旋转 图 片 ， 使 雷 峰 塔 位 “用 _ 保 名片 
于 高 亮 区 域 中 上 部 。 期 间 的 界面 效果 如 图 11-33 与 图 11-34 
所 示 。 其 中 ， 图 11-33 所 示 为 刚 打开 图 片 时 的 初始 界面 ， 图 11-32 长 按 主页 面 弹出 读 写 图 片 
图 11-34 所 示 为 手势 调整 结束 ， 准 备 完成 抠 图 时 的 界面 。 文件 的 菜单 
接 下 来 保存 抠 图 完成 的 图 片 , 在 界面 上 长 按 , 弹出 读 取 图 片 文件 的 菜单 , 如 图 11-35 所 示 。 


打开 图 片 
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图 11-33” 抠 图 开始 前 的 界面 图 11-34 ” 抠 图 完成 后 的 界面 。 图 11-35 长 按 主页 面 准 备 保存 抠 图 


点 击 “ 保 存 图 片 ”， 填 写 保 存 后 的 文件 名 ， 完 成 图 片 保 存 操作 ， 即 可 在 指定 的 路 径 找到 
抠 下 来 的 图 片 。 
下 面 是 响应 抠 图 手势 自 定义 视图 的 代码 : 


public class MeituView extends View { 
private Context mContext; 
private Paint mPaintShade; 


public MeituView(Context context) { 
this(context, null); 


j 


public MeituView(Context context, AttributeSet attrs) í 
super(context, attrs); 
mContext — context; 
mPaintShade — new Paint(); 
mPaintShade.setStyle(Style.FILL); 
mPaintShade.setColor(0x99000000); 

j 


private Bitmap mOrigBitmap = null; 

private Bitmap mCropBitmap = null; 

private Rect mRect = new Rect(0,0,0,0); 

public void setOrigBitmap(Bitmap orig) í 
mOrigBitmap = orig; 


j 

public Bitmap getCropBitmap() í 
return mCropBitmap; 

} 


public boolean setBitmapRect(Rect rect) í 
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; 


if (mOrigBitmap — null) í 
return false; 
} else if (rect.left<0 || rect.left»mOrigBitmap.getWidth()) í 
return false; 
} else if (rect.top«0 || rect.top»mOrigBitmap.getHeight()) { 
return false; 
} else if (rect.right<=0 || rect.left*rect.right»mOrigBitmap.getWidth()) í 
return false; 
} else if (rect.bottom<=0 || rect.top*rect.bottom»mOrigBitmap.getHeight()) í 
return false; 
b 
mRect rect; 
mCropBitmap = Bitmap.createBitmap(mOrigBitmap, 
mRect.left, mRect.top, mRect.right, mRect.bottom); 
postInvalidate(); 
return true; 


public Rect getBitmapRect() í 


j 


return mRect; 


private boolean bReset — false; 

private float mLastOffsetX, mLastOffsetY; 

private float mLastOffsetXTwo, mLastOffsetY Two; 
private long mOriginTime; 


(@Override 
protected void dispatchDraw(Canvas canvas) í 


j 


super.dispatchDraw(canvas); 
if (mOrigBitmap == null) í 

return; 
j 
Rect rectShade = new Rect(0, 0, getMeasuredWidth(), getMeasuredHeight()); 
canvas.drawRect(rectShade, mPaintShade); // 画 外 圈 阴影 
canvas.drawBitmap(mCropBitmap, mRect.left, mRect.top, new Paint()); // 画 高 亮 处 的 图 像 


@Override 
public boolean onTouchEvent(MotionEvent event) { 


int action = event.getAction() & MotionEvent.ACTION_MASK; 
switch (action) { 
case MotionEvent.ACTION_DOWN: 

mOriginTime = event.getEventTime(); 

mOriginX = event.getX(); 
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mOriginY = event.getY(); 
mOriginRect = mRect; 
mbDragMode = getDragMode(mOriginX, mOriginY); 
bReset = true; 
break; 
case MotionEvent. ACTION UP: 
if (mListener !— null && Math.abs(event.getX()-mOriginX)«10 && 
Math.abs(event.getY()-mOriginY)«10) í 
if (event.getEventTime() - mOriginTime < 500) { // 判断 点 击 还 是 长 按 
mListener.onlmageClick(); 
) else í 
mListener.onlmageLongClick(); 


j 
break; 
case MotionEvenL ACTION POINTER DOWN: 
mDragMode = IMAGE SCALE OR ROTATE; // 另 需 判断 缩放 还 是 旋转 
bReset = true; 
break; 
case MotionEvent.ACTION POINTER UP: 
mDragMode = DRAG NONE; 
break; 
case MotionEvent. ACTION MOVE: 
int offsetX — (int) (event.getX()-mOriginX); 
int offsetY = (int) (event.getY()-mOriginY); 
Rect rect = null; 
int left = mOriginRect.left; 
int top = mOriginRect.top; 
int right = mOriginRect.right; 
int bottom — mOriginRect.bottom; 
if(mDragMode = DRAG. NONE) í 
return true; 
) else if (mDragMode = DRAG WHOLE) í 
rect = new Rect(left-offsetX, top*offsetY, right, bottom); 
} else if (mDragMode = DRAG LEFT) í 
rect = new Rect(left*offsetX, top, right-offsetX, bottom); 
) else if (mDragMode = DRAG RIGHT) ( 
rect = new Rect(left, top, right-offsetX, bottom); 
else if (mDragMode = DRAG TOP) { 
rect = new Rect(left, top+offsetY, right, bottom-offsetY ); 
) else if (mDragMode = DRAG BOTTOM) í 
rect = new Rect(left, top, right, bottom-offsetY ); 
} else if (mDragMode = DRAG LEFT TOP) í 
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rect = new Rect(left+offsetX, top+offsetY, right-offsetX, bottom-offsetY); 
} else if (mDragMode = DRAG RIGHT TOP) { 
rect = new Rect(left, top+offsetY, right-offsetX, bottom-offsetY); 
else if (mDragMode = DRAG LEFT BOTTOM) { 
rect = new Rect(left+offsetX, top, right-offsetX, bottom-offsetY); 
} else if (mDragMode = DRAG RIGHT BOTTOM) { 
rect = new Rect(left, top, right-offsetX, bottom-offsetY); 
} else if (mDragMode = IMAGE TRANSLATE) í 
if (mListener != null) í 
mListener.onImageTraslate(offsetX, offsetY, bReset); 
bReset false; 
j 
} else if (mUDragMode = IMAGE SCALE OR ROTATE)( 
if (mListener != null) í 
float nowWholeDistance = distance(event.getX(), event.get Y(), 
event.getX(1), event.getY(1)); 
float preWholeDistance — distance(mLastOffsetX, mLastOffsetY, 
mLastOffsetXTwo, mLastOffsetY Two); 
float primaryDistance = distance(event.getX(), event.getY(), 
mLastOffsetX, mLastOffsetY ); 
float secondaryDistance = distance(event.getX(1), event.getY (1), 
mLastOffsetX Two, mLastOffsetY Two); 
if (Math.abs(nowWholeDistance-pre WholeDistance) > 
(float) Math.sqrt(2y2.0f*(primaryDistance-secondaryDistance)) í /缩放 
mListener.onImageScale(nowWholeDistance / preWholeDistance); 
} else { // 旋转 
int preDegree = degree(mLastOffsetX, mLastOffsetY, 
mLastOffsetX Two, mLastOffset Y Two); 
int nowDegree = degree(event.getX(), event.getY(), 
event.getX(1), event.getY(1)); 
mListener.onImageRotate(nowDegree - preDegree); 


} 
if(mDragMode!=IMAGE TRANSLATE && mDragMode!=IMAGE SCALE OR ROTATE){ 
setBitmapRect(rect); 
; 
break; 
default: 
break; 
; 
mLastOffsetX = event.getX(); 
mLastOffsetY = event.getY(); 
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if (event.getPointerCount() >= 2) í 
mLastOffsetXTwo = event.getX(1); 
mLastOffsetY Two = event.getY(1); 

j 

return true; 

5 


private float distance(float x1, float y1, float x2, float y2) í 

float offsetX = x2 - x1; 

float offsetY = y2 - yl; 

return (float) Math.sqrt(offsetX *offsetX + offset Y *offsetY ); 
j 


private int degree(float x1, float yl, float x2, float y2) í 
retum (int) (Math.atan((y2-y1) / (x2-x1)) / Math.PI * 180); 
1 


private int DRAG_NONE = 0, DRAG_WHOLE = 1, DRAG LEFT -2, DRAG RIGHT = 3; 

private int DRAG TOP =4, DRAG BOTTOM = 5, DRAG LEFT TOP = 6, DRAG RIGHT TOP = 7; 
private int DRAG LEFT BOTTOM - 8, DRAG RIGHT BOTTOM - 9; 

private int IMAGE TRANSLATE = 10, IMAGE SCALE OR ROTATE = 11; 

private int mDragMode - DRAG NONE; 

private int mInterval — 15; 

private float mOriginX, mOriginY; 

private Rect mOriginRect; 


private int getDragMode(float f, float g) { 

int left = mRect.left; 

int top = mRect.top; 

int right = mRect.left + mRect.right; 

int bottom = mRect.top + mRect.bottom; 

if (Math.abs(f-left) -—mlInterval && Math.abs(g-top)-—minterval) í 
return DRAG LEFT. TOP: 

} else if (Math.abs(f-right) -—mlnterval && Math.abs(g-top)--mlnterval) í 
return DRAG RIGHT. TOP; 

} else if (Math.abs(f-left)-—mlnterval && Math.abs(g-bottom)--mlnterval) í 
return DRAG LEFT BOTTOM; 

} else if (Math.abs(f-right) —mlInterval & & Math.abs(g-bottom)-—mlnterval) f 
return DRAG RIGHT. BOTTOM; 

} else if (Math.abs(f-left) —miInterval && g>top+mlnterval && g«bottom-mlInterval) í 
return DRAG LEFT; 

) else if (Math.abs(f-right)-—mlInterval && g>top+mlnterval && g-bottom-mlInterval) í 
return DRAG RIGHT; 

} else if (Math.abs(f-left) —mlnterval && g>top+mlnterval && g«bottom-mlInterval) í 
return DRAG LEFT; 
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} else if (Math.abs(g-top)<—mlnterval && f>leftrmlnterval && f<right-mInterval) í 
return DRAG TOP; 
} else if (Math.abs(g-bottom)--mlnterval && f>leftrmlnterval && f«right-mInterval) í 
return DRAG BOTTOM; 
} else if (£-left-mlInterval && f«right-mInterval && g>top+mlnterval && g«bottom-mlnterval) í 
return DRAG WHOLE; 
} else if (f-mlnterval«left || f-mInterval-right || g*mInterval«top || g-mInterval»bottom) í 
return IMAGE TRANSLATE; 
} else í 
return DRAG NONE; 
$ 
) 
private ImageChangetListener mListener; 
public void setlmageChangetListener(ImageChangetListener listener) í 
mListener = listener; 
) 
public static interface ImageChangetListener í 
public abstract void onlmageClick(); 
public abstract void onlmageLongClick(); 
public abstract void onlmageTraslate(int offsetX, int offsetY, boolean bReset); 
public abstract void onlmageScale(float ratio); 
public abstract void onlmageRotate(int degree); 
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本 章 主 要 介绍 了 App 开发 用 到 的 常见 事件 处 理 , 包括 按键 事件 的 检测 与 处 理 (检测 软 键盘 、 
检测 物理 按键 、 音 量 调节 对 话 框 》、 触 摸 事 件 的 检测 与 处 理 〈 手 势 事件 的 分 发 流程 、 手 势 事件 
处 理 MotionEvent、 手 写 签名 ) 、 手 势 检 测 的 实现 与 用 法 (手势 检测 器 、 飞 掠 视图 、 手 势 控制 横 
幅 轮 播 ) 、 手 势 冲突 的 处 理 方式 (上 下 滚动 与 左右 滑动 的 冲突 处 理 、 内 部 滑动 与 翻 页 滑动 的 冲 
突 处 理 ) 。 最 后 设计 了 一 个 实战 项 目 “ 抠 图 神器 一 一 美 图 变 变 ”， 在 该 项 目的 App 编码 中 采用 
了 本 章 介绍 的 主要 手势 事件 ， 包 括 单 点 触摸 、 多 点 触 控 等 。 另外， 介绍 了 图 像 的 基本 加 工 操作 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 

CD 学 会 在 合适 的 场合 监听 并 处 理 按键 事件 。 

D 学 会 检测 触摸 事件 并 接管 手势 处 理 。 

OD 学 会 使 用 主要 的 手势 检测 手段 。 

(4) 学 会 避免 手势 冲突 的 情况 发 生 。 
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本 章 介绍 App 开发 常见 的 动画 显示 技术 ， 主 要 包括 如 
何 使 用 帧 动画 实现 电影 播放 效果 、 如何 使 用 补 问 动 画 完成 视 
的 4 种 基本 状态 变化 、 如 何 使 用 属性 动画 实现 视图 各 种 状 
态 的 动态 变换 效果 以 及 动画 技术 常用 的 3 种 代表 手段 。 最 后 
结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 仿 QQ 空间 的 动感 
影集 ”的 设计 与 实现 。 
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12.4 Wi z 画 


本 节 介绍 帧 动画 相关 的 技术 实现 ， 首 先 说 明 如 何 通 过 动画 图 形 与 宿主 视图 播放 帧 动画 ， 
接着 阐述 播放 GIF 动画 存在 的 问题 和 对 应 的 解决 思路 与 技术 方案 ， 最 后 介绍 如 何 使 用 过 渡 图 
形 实现 两 幅 图 片 之 间 的 淡 入 、 淡 出 动画 。 


12.1.1 帧 动画 的 实现 


Android 的 动画 分 为 三 大 类 : 帧 动画 、 补 间 动 画 和 属性 动画 。 其 中 ， 帧 动画 是 实现 原理 最 
简单 的 一 种 ， 跟 现实 生活 中 的 电影 胶卷 类 似 , 都 是 在 短 时 间 内 连续 播放 多 张 图 片 ， 从 而 模拟 动 
态 画 面 的 效果 。 

具体 到 代码 实现 , 帧 动画 由 动画 图 形 AnimationDrawable 生成 。 下 面 是 AnimationDrawable 
的 常用 方法 。 


addFrame: 添加 一 幅 图 片 帧 ， 并 指定 该 帧 的 持续 时 间 ( 单位 毫秒 ) 。 

setOneShot: 设置 是 否 只 播放 一 次 。 为 tue 表示 只 播放 一 次 ， 为 false 表示 循环 播放 。 
start: 开始 播放 。 注 意 ， 设 置 宿主 视图 后 才能 进行 播放 。 

stop: 停止 播放 。 

isRunning: 判断 是 否 正在 播放 。 


有 了 动画 图 形 ， 还 得 有 一 个 宿主 视图 显示 该 图 形 ， 一 般 使 用 图 像 视图 ImageView 承载 
AnimationDrawable， 即 调用 ImageView 对 象 的 setImageDrawable 方法 将 动画 图 形 加 载 到 图 像 
视图 中 。 

下 面 是 播放 帧 动画 的 代码 片段 : 


private void showFrameAnimByCode() í 
/ 帧 动画 需要 把 每 帧 图 片 加 入 AnimationDrawable 队列 
ad frame = new AnimationDrawable(); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow pl), 50); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow p2), 50); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow p3), 50); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow p4), 50); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow p5), 50); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow p6), 50); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow p7), 50); 
ad frame.addFrame(getResources().getDrawable(R.drawable.flow p8), 50); 
ad frame.setOneShot(false); 
iv frame anim.setImageDrawable(ad frame); 
ad frame.start(); 
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帧 动画 的 播放 效果 如 图 12-1、 图 12-2、 图 12-3 所 示 。 这 组 帧 动画 实际 由 8 张 瀑布 图 片 构 
成 , 图 中 所 示 的 3 张 画 面 为 其 中 的 3 个 瀑布 帧 , 单 看 画面 区 别 不 大 ， 连 起 来 播放 才能 看 到 瀑布 
的 流水 动画 。 














animation 

















图 12-1 瀑布 动画 帧 1 图 12-2 瀑布 动画 帧 2 图 12-3. 瀑布 动画 帧 3 
除了 在 代码 中 添加 帧 图 片 ， 还 可 以 先 把 帧 图 片 的 排列 定义 在 一 个 XML 文件 中 ; 然后 在 代 






码 中 直接 调用 ImageView 对 象 的 setImageResource 方法 , 加 载 帧 动画 的 图 形 定 义 文 件 ; 再 调用 
ImageView 对 象 的 getDrawable 方法 ， 获 得 动画 图 形 的 实例 ， 并 进行 后 续 的 播放 操作 。 
下 面 是 帧 图 片 的 定义 文件 : 
<animation-list xmlns:android="http://schemas.android.com/apk/res/android" android:oneshot-" false" > 

<item android:drawable="(@drawable/flow_p1" android:duration="50"/> 

<item android:drawable="(@drawable/flow_p2" android:duration="50"/> 

<item android:drawable="(@drawable/flow_p3" android:duration="50"/> 

<item android:drawable="(@drawable/flow_p4" android:duration="50"/> 

«item android:drawable="(@drawable/flow_p5" android:duration="50"/> 

<item android:drawable="(@drawable/flow_p6" android:duration="50"/> 

<item android:drawable="(@drawable/flow_p7" android:duration="50"/> 

«item android:drawable="(@drawable/flow_p8" android:duration="50"/> 


</animation-list> 
从 图 形 定义 文件 中 播放 帧 动画 的 效果 与 在 代码 中 添加 帧 图 片 是 一 样 的 ， 代 码 如 下 : 
private void showFrameAnimByXml() í 
iv_frame_anim.setlmageResource(R.drawable.frame anim); 
ad frame = (AnimationDrawable) iv frame anim.getDrawable(); 
ad frame.start(); 








12.1.2 显示 GIF 动画 


GIF 在 Windows 上 是 常见 的 图 片 格式 ， 主 要 用 来 播放 短小 的 动画 。Android 虽然 号 称 支持 
PNG. JPG. GIF 三 种 图 片 格式 ， 但 是 并 不 支持 直接 播放 GIF 动 图 ， 如 果 在 图 像 视图 中 加 载 一 
张 GIF 文件 ， 只 会 显示 GIF 文件 的 第 一 帧 图 片 。 

要 想 在 手机 上 显示 GIF 文件 ， 就 要 借助 于 帧 动画 技术 ， 具 体 的 实现 方式 主要 有 以 下 两 种 : 


CD 开发 者 在 电脑 上 把 GIF 文件 手工 分 解 为 一 组 帧 图 片 ， 放 入 工程 的 资源 目录 中 ， 再 通 
过 动画 图 形 显示 帧 动画 。 

(2) 在 代码 中 将 GIF 文件 自动 分 解 为 一 系列 图 片 数 据 ， 并 获取 每 帧 的 持续 时 间 ， 然 后 通 
过 动画 图 形 动态 加 载 帧 图 片 。 该 方式 适合 播放 从 服务 器 获取 的 GIF 文件 。 


从 GIF 文件 中 分 解 帧 图 片 有 现成 的 开源 框架 代码 ， 具 体 参见 本 书 的 下 载 资源 。 下 面 是 播 
放 GIF 动 图 的 代码 片段 : 


private void showGifAnimation() { 
ImageView iv_gif = (ImageView) findViewById(R.id.iv gif); 
InputStream is = getResources().openRawResource(R.raw.welcome); 
GifImage gifImage = new Giflmage(); 
int code — gifImage.read(is); 
if (code = Giflmage.STATUS OK) í 
GifImage.GifFrame[] frameList = giflmage.getFrames(); 
AnimationDrawable ad gif = new AnimationDrawable(); 
for (int i-0; icframeList.length; i++) í 
/BitmapDrawable 用 于 把 Bitmap 格式 转换 为 Drawable 格式 
BitmapDrawable bd = new BitmapDrawable(getResources(), frameList[i].image); 
ad gif.addFrame(bd, frameList[i].delay); 
h 
ad gif.setOneShot(false); 
iv gif.setImageDrawable(ad gif); 
ad gif.start(); 
} else if (code == Giflmage.STATUS FORMAT ERROR) í 
Toast.makeText(this, "该 图 片 不 是 gif K", Toast. LENGTH. LONG).show(); 
}else{ 
Toast.makeText(this, "gif 图 片 读 取 失败 :" + code, Toast.LENGTH_LONG).show(); 
s 


GIF 文件 的 播放 效果 如 图 12-4 和 图 12-5 所 示 。 其 中 , 图 12-4 所 示 为 GIF 动 图 播放 开始 时 
的 画面 ， 图 12-5 所 示 为 GIF 动 图 临近 播放 结束 时 的 画面 。 
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a III AM Ne 
图 124 GIF 动画 开始 播放 图 12-5 GIF 动画 播放 结束 
12.1.3” 淡 入 淡出 动画 











帧 动画 的 帧 显示 方式 采用 后 面 一 帧 直接 覆盖 前 面 一 帧 ， 这 在 快速 轮 播 时 没什么 问题 ， 但 
是 如 果 每 帧 的 间隔 时 间 比 较 长 〈 比 如 超过 0.5 秒 ) ， 两 帧 之 间 的 画面 切换 就 会 很 生硬 ， 直 接 从 
前 一 帧 变 成 后 一 帧 会 让 人 觉得 很 突 元 。 为 了 解决 这 种 长 间隔 切换 图 片 在 视觉 效果 方面 的 问题 ， 
Android 提供 了 过 渡 图 形 TransitionDrawable 处 理 两 张 图 片 之 间 的 渐变 显示 ， 即 淡 入 淡出 的 动 
画 效果 。 

过 渡 图 形 同 样 需要 宿主 视图 显示 该 图 形 ， 即 调用 ImageView 对 象 的 setlmageDrawable 77 
法 进行 图 形 加 载 操 作 。 下 面 是 TransitionDrawable 的 常用 方法 说 明 。 


构造 函数 : 指定 过 渡 图 形 的 图 形 数 组 。 该 图 形 数组 大 小 为 2， 包含 前 后 两 张 图 形 。 
startTransition: 开始 过 渡 操 作 。 这 里 需要 先 设置 宿主 视图 ， 然 后 才能 进行 渐变 显示 。 
resetTransition: 重 置 过 渡 操 作 。 
reverseTransition: 倒 过 来 执行 过 渡 操 作 。 
下 面 是 使 用 过 渡 图 形 的 代码 片段 : 
private void showFadeAnimation() { 
// 淡 入 淡出 动画 需要 先 设置 一 个 Drawable 数组 ， 用 于 变换 图 片 
Drawable[] drawableArray = í 
getResources().getDrawable(R.drawable.fade_begin), 
getResources().getDrawable(R.drawable.fade_end) 
h 
TransitionDrawable td fade = new TransitionDrawable(drawableArray); 
iv fade anim.setImageDrawable(td fade); 
td. fade.startTransition(3000); 
} 
过 渡 图 形 的 播放 效果 如 图 12-6 和 图 12-7 所 示 。 其 中 ， 图 12-6 所 示 为 开始 转换 不 久 的 画 
面 ， 此 时 仍 以 第 一 张 图 片 为 主 ， 图 12-7 所 示 为 转换 将 要 结束 的 画面 ， 此 时 已 经 基本 过 渡 到 第 
二 张 图 片 。 


- 456 。 

















图 12-6 淡 入 淡出 动画 开始 播放 图 12-7 淡 入 淡出 动画 即将 结束 
至 此 ，Android 的 主要 图 形 类 都 在 本 书 做 了 介绍 ， 为 方便 读者 查阅 ， 这 里 总 结 整理 一 下 ， 


简要 说 明 见 表 12-1。 





表 12-1 Android 的 主要 图 形 类 说 明 




















Drawable 图 形 类 | 说 明 XML 节点 名 称 参考 章节 

ColorDrawable 颜色 图 形 color 第 2 章 的 “2.1.2 颜色 ” 
StateListDrawable 状态 列表 图 形 | selector 第 2 章 的 “2.4.2 状态 列表 图 形 ” 
ShapeDrawable 形状 图 形 shape 第 2 章 的 “2.4.3 形状 图 形 ” 
GradientDrawable 渐变 图 形 gradient 第 2 章 的 “2.4.3 形状 图 形 ” 
NinePatchDrawable | 点 九 图 形 nine-patch 第 2 章 的 “2.4.4 九宫 格 图 片 ” 
LayerDrawable 层次 图 形 layer-list 第 6 章 的 “6.4.2 进度 条 ProcessBar” 
ClipDrawable 裁剪 图 形 clip 第 6 章 的 “6.4.2 进度 条 ProcessBar” 
BitmapDrawable 位 图 图 形 bitmap 第 11 章 的 “11.5.2 小 知识 : 图 像 的 基本 加 工 ” 
AnimationDrawable | 动画 图 形 animation-list 第 12 章 的 “12.1.1 帧 动画 的 实现 ” 
TransitionDrawable | 过 渡 图 形 transition 第 12 章 的 “12.1.3 淡 入 淡出 动画 ” 


12.2 #RFliJ#Jimi 


本 节 介 绍 补 间 动画 的 原理 与 用 法 ， 首 先 指出 补 间 动 画 有 四 大 类 ， 分 别 是 灰 度 动画 、 平 移 
动画 、 缩 放 动画 和 旋转 动画 ,介绍 这 4 种 动画 的 基本 用 法 ; 接着 阐述 补 间 动 画 的 原理 ， 基 于 旋 
转动 画 的 思想 实现 摇摆 动画 ; 然后 介绍 如 何 使 用 集合 动画 同时 展示 多 种 动画 效果 ; 最 后 就 第 
11 章 的 飞 掠 横幅 遗留 问题 给 出 使 用 动画 技术 平滑 切换 前 后 视图 的 方案 。 
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12.2.1 补 间 动 画 的 种 类 


12.1 节 提 到 两 张 图片 之 间 的 渐变 效果 可 以 使 用 过 渡 图 形 TransitionDrawable 实现 。 一 张 图 
形 内 部 能 和 否 运用 渐变 效果 ? 比如 对 图 片 的 大 小 进行 自动 缩放 等 。 正 好 ，Android 提供 了 补 间 动 
画 ， 允 许 开发 者 实现 某 个 视图 的 动态 变换 ,具体 包括 4 类 动画 效果 ， 分 别 是 灰 度 动画 、 平 移动 
m. 缩放 动画 和 旋转 动画 。 为 什么 把 这 4 种 动画 称 为 补 间 动 画 呢 ?因为 由 开发 者 提供 动画 的 起 
始 状 态 值 与 终止 状态 值 , 然后 系统 按照 时 间 推 移 计 算 中 间 的 状态 值 , 并 自动 把 中 间 状 态 的 视图 
补充 到 起 止 视图 中 ， 自 动 补充 中 间 视 图 的 动画 就 被 简称 为 “ 补 间 动 画 ”。 

补 间 动 画 的 4 类 动画 〈 灰 度 动画 AlphaAnimation、 平 移动 画 TranslateAnimation、 缩 放 动 
Mj ScaleAnimation 和 旋转 动画 RotateAnimation ) 都 来 自 于 共同 的 动画 类 Animation， 因 此 同时 
拥有 Animation 的 属性 与 方法 。 下 面 是 Animation 的 常用 方法 说 明 。 


e setFillAfter: 设置 是 否 维持 结束 画面 。true 表示 动画 结束 后 停留 在 结束 画面 ，false 表示 动 
画 结束 后 恢复 到 开始 画面 。 

e setRepeatMode: 设置 重播 模式 . Animation.RESTART 表示 从 头 开始 , Animation. REVERSE 

表示 倒 过 来 开始 。 默 认为 Animation.RESTART。 

setRepeatCount: 设置 重播 次 数 。 默 认为 0 表示 只 播放 一 次 。 

setDuration: 设置 动画 的 持续 时 间 。 单 位 毫秒 。 

setInterpolator: 设置 动画 的 插值 器 。 

setAnimationListener: 设置 动画 事件 的 监听 器 。 需 实现 接口 AnimationListener 的 3 个 方法 。 


» onAnimationStart: 在 动画 开始 时 触发 。 
> onAnimationEnd: 在 动画 结束 时 触发 。 
> onAnimationRepeat: 在 动画 重播 时 触发 。 


与 帧 动画 一 样 ， 补 间 动 画 也 需要 找 一 个 宿主 视图 ， 对 宿主 视图 施展 动画 效果 。 不 同 的 是 ， 
帧 动画 的 宿主 视图 只 能 是 ImageView 相关 的 图 像 视图 ， 而 补 间 动 画 的 宿主 视图 可 以 是 任意 视 
图 ， 只 要 派生 自 View 类 就 行 。 给 补 间 动画 指定 宿主 视图 的 方式 很 简单 ， 调 用 宿主 对 象 的 
startAnimation 方法 即 可 命令 宿主 视图 开始 动画 , 调用 宿主 对 象 的 clearAnimation 方法 即 可 要 求 
宿主 视图 清除 动画 。 

具体 到 每 种 补 间 动 画 又 有 不 同 的 初始 化 方式 。 下 面 来 看 具体 说 明 。 


(1) 初始 化 灰 度 动画 : 在 构造 函数 中 指定 视图 透明 度 的 前 后 数值 。 取 值 为 0.0—1.0, 0 
表示 完全 不 透明 ，1 表示 完全 透明 。 

(2) 初始 化 平移 动画 : 在 构造 函数 中 指定 视图 左上 角 在 平移 前 后 的 坐标 值 。 其 中 ， 第 一 
个 参数 为 平移 前 的 横 坐 标 ， 第 二 个 参数 为 平移 后 的 横 坐 标 ， 第 三 个 参数 为 平移 前 的 纵 坐 标 ， 第 
四 个 参数 为 平移 后 的 纵 坐 标 。 

G) 初始 化 缩放 动画 : 在 构造 函数 中 指定 视图 横 纵 坐 标的 前 后 缩放 比例 。 缩 放 比例 取 值 
0.5 表示 缩小 到 原来 的 二 分 之 一 ， 取 值 2 表示 放大 到 原来 的 两 倍 。 其 中 ， 第 一 个 参数 为 缩放 前 
的 横 坐 标 比 例 ， 第 二 个 参数 为 缩放 后 的 横 坐 标 比例 ， 第 三 个 参数 为 缩放 前 的 纵 坐 标 比例 ,第 四 
个 参数 为 缩放 后 的 纵 坐 标 比例 。 
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(4) 初始 化 旋转 动画 : 在 构造 函数 中 指定 视图 的 旋转 角度 。 其 中 ， 第 一 个 参数 为 旋转 前 
的 角度 ， 第 二 个 参数 为 旋转 后 的 角度 ， 第 三 个 参数 为 圆心 的 横 坐 标 类 型 ， 第 四 个 参数 为 圆心 横 
坐标 的 数值 比例 ， 第 五 个 参数 为 圆心 的 纵 坐 标 类 型 ， 第 六 个 参数 为 圆心 纵 坐 标的 数值 比例 。 坐 
标 类 型 的 取 值 说 明 见 表 12-2。 





>= 











312-2 ”坐标 类 型 的 取 值 说 明 














Animation 类 的 坐标 类 型 说 明 
ABSOLUTE 绝对 位 置 
RELATIVE TO_SELF 相对 自身 位 置 
RELATIVE TO_PARENT 相对 上 级 位 置 


下 面 是 使 用 4 种 补 间 动 画 的 代码 : 


public class TweenAnimActivity extends AppCompatActivity implements AnimationListener í 
private ImageView iv tween anim; 
private Animation alphaAnim, translateAnim, scaleAnim, rotateAnim; 


(a Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity tween anim); 
iv tween anim = (ImageView) findViewById(R.id.iv tween anim); 
initAnim(); 
initTweenSpinner(); 


private void initAnim() { 
U 从 完全 透明 变 为 即将 不 透明 
alphaAnim = new AlphaAnimation(1.0f 0.1f); 
alphaAnim.setDuration(3000); 
alphaAnim.setFillA fter(true); 
/ 向 左 平移 200 
translateAnim = new Translate Animation(1.0f, -200f, 1.0f, 1.0f); 
translateAnim.setDuration(3000); 
translateAnim.setFillA fter(true); 
/ 宽度 不 变 ， 高 度 变 为 原来 的 二 分 之 一 
scaleAnim = new ScaleAnimation(1.0f 1.0f, 1.0f, 0.5f); 
scaleAnim.setDuration(3000); 
scaleAnim.setFillA fter(true); 
/ 围绕 着 圆心 顺 时 针 旋 转 360 度 
rotateAnim = new RotateAnimation(0f, 360f Animation.RELATIVE TO SELF, 
0.5f, Animation.RELATIVE TO SELF, 0.509); 
rotateAnim.setDuration(3000); 
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rotateAnim.setFillA fter(true); 


private void initTweenSpinner() í 

ArrayAdapter-String^ tweenAdapter = new ArrayAdapter-String-(this, 
R.layout.item select, tweenArray); 

Spinner sp tween = (Spinner) findViewById(R.id.sp tween); 

sp_tween.setPrompt(" 请 选择 补 间 动 画 类 型 "); 

sp tween.setAdapter(tweenA dapter); 

sp tween.setOnltemSelectedListener(new TweenSelectedListener()); 

sp tween.setSelection(0); 





private String[] tweenArray={" 灰 度 动画 ", "平移 动画 ", "缩放 动画 ", "旋转 动画 "}; 
class TweenSelectedListener implements OnltemSelectedListener í 
public void onltemSelected( AdapterView<?> arg0, View argl, int arg2, long arg3) { 
if (arg? — 0) ( 
iv tween anim.startAnimation(alphaAnim); 
alphaAnim.setAnimationListener(TweenAnimActivity.this); 
) else if (arg2 = 1) { 
iv tween anim.startAnimation(translateAnim); 
translateAnim.setAnimationListener( TveenAnimActivity.this); 
) else if (arg2 = 2) { 
iv tween anim.startAnimation(scaleAnim); 
scaleAnim.setAnimationListener( TweenAnimActivity.this); 
} else if (arg2 = 3) ( 
iv tween anim.startAnimation(rotateAnim); 
rotateAnim.setAnimationListener( TweenAnimActivity.this); 


public void onNothingSelected(AdapterView-?- arg0) í 
J 


(@Override 
public void onAnimationStart( Animation animation) í 
; 


@Override 
public void onAnimationEnd(Animation animation) { 
if (animation.equals(alphaAnim)) í 
Animation alphaAnim2 = new AlphaAnimation(0. 1f, 1.0f); 











alphaAnim2.setDuration(3000); 
alphaAnim2.setFillA fter(true); 
iv_tween_anim.startAnimation(alphaAnim2); 
} else if (animation.equals(translateAnim)) í 
Animation translateAnim2 = new TranslateAnimation(-200f, 1.0f, 1.0f, 1.0f); 
translateAnim2.setDuration(3000); 
translateAnim2.setFillA fter(true); 
iv tween anim.startAnimation(translateAnim2); 
} else if (animation.equals(scaleAnim)) í 
Animation scaleAnim2 = new ScaleAnimation(1.0f, 1.0f, 0.5f, 1.0f); 
scaleAnim2.setDuration(3000); 
scaleAnim2.setFillA fter(true); 
iv tween anim.startAnimation(scaleAnim2); 
} else if (animation.equals(rotateAnim)) í 
Animation rotateAnim2 = new RotateAnimation(Of, -360f, 
Animation.RELATIVE TO SELF, 0.5f, Animation.RELATIVE TO SELF, 0.5f); 


rotateAnim2.setDuration(3000); 
rotateAnim2.setFillA fter(true); 
iv tween anim.startAnimation(rotateAnim2); 
J 
j 
(@Override 


public void onAnimationRepeat( Animation animation) { 
j 
j 
补 间 动 画 的 播放 效果 如 图 12-8 一 图 12-15 所 示 。 其 中 ， 图 12-8 和 图 12-9 所 示 为 灰 度 动画 
播放 前 后 的 画面 ， 图 12-10 和 图 12-11 所 示 为 平移 动画 播放 前 后 的 画面 ， 图 12-12 和 图 12-13 
所 示 为 缩放 动画 播放 前 后 的 画面 ， 图 12-14 和 图 12-15 所 示 为 旋转 动画 播放 前 后 的 画面 。 





补 间 动 画 类 型 : 灰 度 动画 x 补 间 动 画 类 型 : 灰 度 动画 











图 12-8” 灰 度 动画 开始 播放 图 12-9 灰 度 动画 即将 结束 
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补 间 动画 类 型 : 平移 动画 V 补 间 动 画 类 型 : 平移 动画 
12-10 平移 动画 开始 播放 图 12-11 平移 动画 即将 结束 


补 间 动 画 类 型 缩放 动画 补 间 动 画 类 型 : 缩放 动画 











图 12-12 缩放 动画 开始 播放 图 12-13 ”缩放 动画 即将 结束 





补 间 动 画 类 型 : 旋转 动画 M 补 间 动 画 类 型 : 旋转 动画 


12-14 ”旋转 动画 开始 播放 图 12-15 旋转 动画 正在 播放 


12.2.2 补 间 动画 的 原理 














补 间 动 画 只 提供 了 基本 的 动态 变换 ， 如 果 想 要 复杂 的 动画 效果 ， 比 如 像 钟 摆 一 样 左 摆 一 
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REGE F, 补 间 动 画 就 无 能 为 力 了 。 我们 有 必要 了 解 补 间 动 画 的 实现 原理 ,这样 才 能 进行 
适当 的 改造 ， 使 其 符合 实际 的 业务 需求 。 
下 面 以 旋转 动画 RotateAnimation 为 例 说 明 补 间 动 画 的 实现 原理 。 查 看 RotateAnimation 的 
源码 ， 发 现 除 了 一 堆 构造 函数 外 ， 剩 下 的 代码 只 有 3 个 函数 : 
private void initializePivotPoint() í 
if (mPivotXType — ABSOLUTE) ( 
mPivotX = mPivotX Value; 
} 
if (mPivotY Type = ABSOLUTE) { 
mPivotY = mPivotY Value; 
h 
5 


@Override 

protected void applyTransformation(float interpolatedTime, Transformation t) { 
float degrees = mFromDegrees + ((mToDegrees - mFromDegrees) * interpolatedTime); 
float scale = getScaleFactor(); 


if (mPivotX = 0.0f && mPivotY == 0.0f) í 


t.getMatrix().setRotate(degrees); 
) else { 
t.getMatrix().setRotate(degrees, mPivotX * scale, mPivotY * scale); 
j 
ji 
@Override 


public void initialize(int width, int height, int parentWidth, int parentHeight) { 
super.initialize(width, height, parent Width, parentHeight); 
mPivotX = resolveSize(mPivotXType, mPivotX Value, width, parent Width); 
mPivotY = resolveSize(mPivotY Type, mPivotY Value, height, parentHeight); 
ji 
注意 两 个 初始 化 函数 都 在 处 理 圆 心 的 坐标 ， 实 际 与 动画 播放 有 关 的 代码 只 有 
applyTransformation 方法 。 该 方法 很 简单 ， 提 供 了 两 个 输入 参数 ， 第 一 个 参数 为 插值 时 间 ， 即 
逝去 的 时 间 所 占 的 百分比 , 第 二 个 参数 为 转换 器 。 方法 内 部 根据 插值 时 间 计算 当前 所 处 的 角度 
degrees， 最 后 使 用 转换 器 把 视图 旋转 到 该 角度 。 
查看 其 他 补 间 动画 的 源码 ， 发 现 都 与 RotateAnimation 的 处 理 大 同 小 异 ， 对 中 间 状 态 的 视 
图 变换 处 理 不 外 乎 以 下 两 个 步骤 : 


E 根据 插值 时 间 计算 当前 的 状态 值 (如 灰 度 、 距 离 、 比 率 、 角 度 等 ) 。 
ED 在 宿主 视图 上 使 用 该 状态 值 进行 变换 操作 。 
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如 此 看 来 ， 补 间 动 画 的 关键 在 于 利用 插值 时 间 计算 状态 值 。 现 在 回头 看 看 钟 摆 的 左右 摆 
动 ， 这 个 摆动 操作 其 实 由 3 段 旋转 动画 构成 。 


a) 以 上 面 的 端点 为 圆心 ， 钟 摆 以 垂直 向 下 的 状态 向 左旋 转 ， 转 到 左边 的 某 个 角度 停 住 
(比如 左 转 60 度 ) 。 

(2) 钟 摆 从 左边 向 右边 旋转 ， 转 到 右边 的 某 个 角度 停 住 〈 比 如 右 转 120 度 ， 与 垂直 方向 
的 夹 角 为 60 度 ) 。 

G) 钟 摆 从 右边 再 向 左旋 转 ， 当 其 摆 到 垂直 方向 时 ， 完 成 一 个 周期 的 摇摆 动作 。 


弄 清楚 了 摇摆 动画 的 运动 过 程 ， 接 下 来 根据 插值 时 间 计 算 对 应 的 角度 。 具 体 到 代码 实现 
上 ， 需 要 做 以 下 两 处 调整 : 


CD 旋转 动画 初始 化 时 只 有 两 个 度数 ， 即 起 始 角度 和 终止 角度 。 摇 摆动 画 需要 3 个 参数 ， 
即 中 间 角 度 〈 既 是 起 始 角度 也 是 终止 角度 ) 、 摆 到 左 侧 的 角度 和 摆 到 右 侧 的 角度 。 

(2) 根据 插值 时 间 估 算 当前 所 处 的 角度 。 对 于 摇摆 动画 来 说 ， 需 要 做 3 个 分 支 判断 〈 对 
应 之 前 3 段 旋转 动画 ) 。 如 果 整 个 动画 持续 4 秒 ， 那 么 0 一 1 秒 为 往 左 的 旋转 动画 ， 该 区 间 的 
起 始 角度 为 中 间 角 度 ， 终 止 角度 为 摆 到 左 侧 的 角度 ，1 一 3 秒 为 往 右 的 旋转 动画 ， 该 区 间 的 起 
始 角度 为 摆 到 左 侧 的 角度 ， 终 止 角度 为 摆 到 右 侧 的 角度 ; 3 一 4 秒 为 往 左 的 旋转 动画 ， 该 区 间 
的 起 始 角度 为 摆 到 右 侧 的 和 角度， 终止 角 度 为 中 间 角 度 。 


分 析 完 毕 ， 贴 上 修改 后 的 摇摆 动画 代码 片段 : 


protected void applyTransformation(float interpolatedTime, Transformation t) í 
float degrees; 
float leftPos = (float) (1.0 / 4.0); 
float rightPos = (float) (3.0 / 4.0); 
if (interpolatedTime <= leftPos) { 
degrees = mMiddleDegrees + ((mLeftDegrees - mMiddleDegrees) * interpolatedTime * 4); 
) else if (interpolatedTime > leftPos && interpolatedTime < rightPos) í 
degrees = mLeftDegrees + ((mRightDegrees-mLeftDegrees) * (interpolatedTime-leftPos) * 2); 
} else ( 
degrees = mRightDegrees+ ((mMiddleDegrees-mRightDegrees)*(interpolatedTime-rightPos)*4); 
j; 








float scale = getScaleFactor(); 
if (mPivotX = 0.0f && mPivotY = 0.0f) { 
t.getMatrix().setRotate(degrees); 
} else { 
t.getMatrix().setRotate(degrees, mPivotX * scale, mPivotY * scale); 
H 
; 


摇摆 动画 的 播放 效果 如 图 12-16 和 图 12-17 所 示 。 其 中 ， 图 12-16 所 示 为 钟 摆 向 左 摆动 时 
的 画面 ， 图 12-17 所 示 为 钟 摆 向 右 摆动 时 的 画面 。 








animation 








图 12-16 ”摇摆 动画 向 左 摆动 图 12-17 ”摇摆 动画 向 右 摆动 
1223 ”集合 动画 


有 时 ， 一 个 动画 效果 会 揉 合 多 种 动画 技术 ， 比 如 一 边 旋转 、 一 边 缩放 用 到 集合 动画 
AnimationSet， 把 几 个 补 间 动 画 组 装 起 来 ， 实 现 让 某 视图 同时 呈现 多 种 动画 的 效果 。 

集合 动画 与 补 间 动 画 一 样 继承 自 Animation 类 ， 所 以 拥有 补 间 动 画 的 基本 方法 。 但 集合 动 
画 不 像 一 般 补 间 动 画 那 样 提供 构造 函数 ， 而 是 通过 addAnimation 方法 把 别 的 补 问 动 画 加 入 本 
集合 动画 中 。 

下 面 是 使 用 集合 动画 的 代码 片段 : 


private void initAnim() { 
alphaAnim = new AlphaAnimation(1.0f, 0.1f); // 灰 度 动画 
alphaAnim.setDuration(3000); 
alphaAnim.setFillAfter(true); 
translateAnim = new TranslateAnimation(1.0f -200f, 1.0f, 1.0); // 平移 动画 
translateAnim.setDuration(3000); 
translateAnim.setFillA fter(true); 
scaleAnim = new ScaleAnimation(1.0f, 1.0f, 1.0£,0.5f); — // 缩放 动画 
scaleAnim.setDuration(3000); 
scaleAnim.setFillA fter(true); 
rotateAnim = new RotateAnimation(0f, 360f Animation.RELATIVE TO SELF, 

0.5f, Animation.RELATIVE TO SELF,0.5f; // 旋转 动画 

rotateAnim.setDuration(3000); 
rotateAnim.setFillA fter(true); 
setAnim = new AnimationSet(true); // 集合 动画 
setAnim.addAnimation(translate Anim); 
setAnim.addAnimation(alphaAnim); 
setAnim.addAnimation(scaleAnim); 
setAnim.addAnimation(rotateAnim); 
setAnim.setFillA fter(true); 
iv anim setstartAnimation(setAnim); 
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setAnim.setAnimationListener(this); 
) 
集合 动画 的 播放 效果 如 图 12-18 和 图 12-19 所 示 。 其 中 ， 图 12-18 所 示 为 集合 动画 开始 不 
久 的 画面 ， 图 12-19 所 示 为 集合 动画 即将 结束 的 画面 。 








图 12-18 ”集合 动画 开始 播放 不 久 图 12-19 集合 动画 即将 结束 播放 
帧 动画 允许 在 XML 文件 中 存放 动画 定义 ， 补 间 动 画 也 允许 ， 就 连 集合 动画 都 可 以 放 在 一 
块 描述 。 下 面 是 一 个 集合 动画 的 XML 文件 定义 的 例子 ， 其 中 包含 4 个 补 间 动 画 定义 : 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
«alpha android:duration="3000" android:fromAlpha="1.0" android:toAlpha="0.1" /> 
«translate android:duration="3000" android:fromXDelta-"1.0" android:toXDelta="-200" 
android:fromY Delta="1.0" android:toY Delta="1.0" /> 
<scale android:duration="3000" android:fromXScale="1.0" android:toXScale="1.0" 
android:fromY Scale="1.0" android:toY Scale="0.5" /> 
<rotate android:duration="3000" android:fromDegrees="0" android:toDegrees="360" 
android:pivotX="50%" android:pivotY="50%" /> 
</set> 


在 代码 中 调用 动画 工具 AnimationUtils 的 loadAnimation 方法 ， 即 可 加 载 该 集合 动画 的 文 
件 定义 ， 无 须 在 代码 中 定义 其 他 4 种 补 间 动 画 。 具 体 加 载 代码 如 下 : 
setAnim.addAnimation(AnimationUtils.loadAnimation(this, R.anim.anim set)); 
使 用 上 述 XML 文件 演示 集合 动画 的 效果 如 图 12-18 和 图 12-19 所 示 ， 画 面 效果 与 代码 定 
义 方式 没什么 区 别 。 


12.2.4 在 飞 掠 横幅 中 使 用 补 间 动画 





第 11 章 介绍 飞 掠 视图 ViewFlipper 时 ， 结 合 手势 检测 器 GestureDetector 实现 了 飞 掠 横幅 
的 效果 。 不 过 前 后 Banner 的 飞 掠 切换 有 些 生硬 ， 后 面 的 广告 图 一 下 子 把 前 面 的 广告 图 覆盖 ， 
显得 十 分 突 元 ， 完 全 不 如 ViewPager 那样 翻 页 自然 。 现 在 我 们 正好 活 学 活用 ， 试 试 利用 补 间 动 
画 技术 给 飞 掠 横幅 加 上 动画 翻 页 变换 ， 看 看 能 否 达到 自然 翻 页 的 预期 效果 。 

第 11 章 提 到 ，ViewFlipper 有 以 下 4 个 操作 动画 的 方法 : 

e setlnAnimation: 设置 视图 的 移入 动画 。 

e getlnAnimation: 获取 移入 动画 的 动画 对 象 。 











e setOutAnimation: 设置 视图 的 移出 动画 。 
e getOutAnimation: 获取 移出 动画 的 动画 对 象 。 
通过 这 4 个 动画 方法 加 载 动画 定义 ， 应 该 能 实现 飞 掠 视图 前 后 切换 的 动画 效果 。 
首先 定义 几 个 动画 定义 文件 ， 用 来 描述 移入 动画 和 移出 动画 的 行为 。 具 体 地 说 ， 包 括 4 
个 动画 定义 文件 : 向 左 移入 动画 、 向 左 移出 动画 、 向 右 移入 动画 和 向 右 移 出 动画 。 下 面 对 这 4 
个 动画 定义 文件 分 别 进行 说 明 。 
(1) 向 左 移入 动画 ， 用 来 描述 Banner 向 左 翻 页 时 右边 页 面 的 移入 行为 ， 动 画 文件 名 为 
push_left_in.xml， 文 件 内 容 如 下 : 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
«translate android:duration="1500" android:fromXDelta-" 100.0?6p" android:toXDelta="0.0" /> 
«alpha android:duration-" 1500" android:fromAlpha-"0.1" android:toAlpha-"1.0" /> 
</set> 


(2) 向 左 移出 动画 ， 用 来 描述 Banner 向 左 翻 页 时 左边 页 面 的 移出 行为 ， 动 画 文件 名 为 
push_left_out.xml， 文 件 内 容 如 下 : 
«set xmlns:android="http://schemas.android.com/apk/res/android"> 
«translate android:duration="1500" android:fromX Delta="0.0" android:toXDelta="-100.0%p" > 
«alpha android:duration="1500" android:fromAlpha="1.0" android:toAlpha="0.1" > 
</set> 


G) 向 右 移 入 动画 ， 用 来 描述 Banner 向 右 翻 页 时 左边 页 面 的 移入 行为 ， 动 画 文 件 名 为 
push_right_in.xml， 文 件 内 容 如 下 : 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
«translate android:duration="1500" android:fromXDelta="-100.0%p" android:toXDelta="0.0" /> 
<alpha android:duration="1500" android:fromAlpha="0.1" android:toAlpha-"1.0" /> 
</set> 
(4) 向 右 移出 动画 ， 用 来 描述 Banner 向 右 翻 页 时 右边 页 面 的 移出 行为 ， 动 画 文件 名 为 
push_right_out.xml， 文 件 内 容 如 下 : 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
«translate android:duration="1500" android:fromX Delta="0.0" android:toXDelta="100.0%p" > 
«alpha android:duration=" 1500" android:fromAlpha="1.0" android:toAlpha="0.1" > 
</set> 
在 第 11 章 的 BannerFlipper 代码 中 补充 以 下 片段 ， 加载 相 关 动 画 定 义 文件 ， 并 在 翻 页 时 展 
示 动 画 : 
private void startFlip() í 
mFlipper.startFlipping(); 
mFlipper.setInAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push left in)); 
mFlipper.setOutAnimation( AnimationUtils.load Animation(mContext, R.anim.push left out)); 
mFlipper.getOutAnimation().setAnimationListener(new BannerAnimationL istener(this)); 
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j 


mFlipper.showNext(); 


private void backFlip() í 


1 


mFlipper.startFlipping(); 

mFlipper.setInAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push right_in)); 
mFlipper.setOutAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push right out)); 
mFlipper.getOutAnimation().setAnimationListener(new BannerAnimationL istener(this)); 
mFlipper.showPrevious(); 

mFlipper.setInAnimation(AnimationUtils.loadAnimation(mContext, R.anim.push left in)); 
mFlipper.setOutAnimation( AnimationUtils.loadAnimation(mContext, R.anim.push left out)); 
mFlipper.getOutAnimation().setAnimationListener(new BannerAnimationL istener(this)); 


private class BannerAnimationListener implements Animation.AnimationListener í 


j 


private BannerAnimationListener(BannerFlipper bannerFlipper) í 

h 

(@Override 

public final void onAnimationEnd(Animation paramAnimation) í 
int position = mFlipper.getDisplayedChild(); 
((RadioButton) mGroup.getChildAt(position)).setChecked(true); 

J 

@Override 

public final void onAnimationRepeat(Animation paramAnimation) { 

J 

@Override 

public final void onAnimationStart(Animation paramAnimation) { 

b 


改造 后 的 飞 掠 横幅 在 翻 页 时 的 动画 效果 如 图 12-20 和 图 12-21 所 示 。 其 中 ， 图 12-20 所 示 
为 向 左 翻 页 开始 不 久 的 画面 ,右边 页 面 逐步 移入 且 色 彩 渐渐 淡 入 ; 图 12-21 所 示 为 向 左 翻 页 即 


将 结束 时 的 E 





画面 ， 左 边 页 面 逐步 移出 且 色 彩 渐渐 淡出 。 


animation 




















= 
图 12-20 ” 飞 掠 横幅 开始 向 左 翻 页 图 12-21 飞 掠 横幅 左 翻 即将 结束 


读者 是 否 注意 到 , 集成 了 动画 效果 的 飞 掠 横幅 与 第 7 章 的 横幅 轮 播 Banner 竟 有 几 分 相似 。 
采用 不 同 技术 实现 的 效果 殊途同归 ， 这 正 是 Android 开发 的 魅力 所 在 。 
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本 节 介 绍 属性 动画 的 应 用 场合 与 进 阶 用 法 ， 首 先 说 明 为 何 属性 动画 是 补 间 动 画 的 升级 版 ， 
以 及 属性 动画 的 基本 用 法 ;接着 说 明 如 何 运用 属性 动画 组 合 实现 多 个 属性 动画 的 同时 播放 与 顺 
序 播放 效果 ; 最 后 对 动画 技术 中 的 插值 器 和 估 值 器 进行 分 析 ， 并 演示 不 同 插值 器 的 动画 效果 。 
12.8.4 属性 动画 的 用 法 


视图 View 有 许多 状态 属性 ，4 种 补 间 动 画 只 对 其 中 6 种 属性 进行 操作 ， 这 6 种 属性 的 说 
明 见 表 12-3。 
表 12-3” 补 间 动 画 的 属性 说 明 











View 类 的 属性 名 称 属性 说 明 属性 设置 方法 对 应 的 补 间 动 画 
alpha 透明 度 setAlpha 灰 度 动画 
rotation setRotation | 旋转 动画 
scaleX 横 坐 标的 缩放 比例 setScaleX 缩放 动画 
scalcY LITT) 


translationX setTranslationX 平移 动画 
translationY setTranslationY 平移 动画 

每 个 控件 的 属性 远 不 止 这 6 种 ， 如 果 要 求 对 视图 的 背景 颜色 做 渐变 处 理 ， 补 间 动 画 就 无 
能 为 力 了 。 为 此 ，Android 自 3.0 后 引入 了 属性 动画 ObjectAnimator， 属 性 动画 突破 了 补 间 动 
画 的 局 上限， 允许 视 图 的 所 有 属性 都 能 实现 渐变 的 动画 效果 ,例如 背景 颜色 、 文 字 颜色 、 文 字 大 
小 等 。 只 要 设 定 某 属性 的 起 始 值 与 终止 值 、 渐 变 的 持续 时 间 ， 属 性 动画 即 可 实现 该 属性 的 动画 
渐变 效果 。 

下 面 是 ObjectAnimator 的 常用 方法 。 

e ofin: 定义 整 型 属性 的 属性 动画 。 

e ofFloat: 定义 浮 点 型 属性 的 属性 动画 。 

e ofArgb: 定义 颜色 属性 的 属性 动画 。 

e ofObject: 定义 对 象 属性 的 属性 动画 。 用 于 不 是 上 述 三 种 类 型 的 属性 ， 例 如 Rect 对 象 。 

以 上 4 个 of 方法 的 第 一 个 参数 为 宿主 视图 对 象 ， 第 二 个 参数 为 需要 变化 的 属性 名 称 ， 第 
三 个 参数 后 为 属性 变化 的 各 个 状态 值 。 注 意 ，of 方法 后 面 的 参数 个 数 是 变化 的 。 如 果 第 3 个 
参数 是 状态 A， 第 4 个 参数 是 状态 B， 属 性 动画 就 从 A 状态 变 为 B 状态 ; 如 果 第 3 个 参数 是 
状态 A， 第 4 个 参数 是 状态 B， 第 5 个 参数 是 状态 C， 属 性 动画 就 先 从 A 状态 变 为 B 状态 ， 
再 从 B 状态 变 为 C 状态 。 

e setRepeatMode: 设置 重播 模式 。ValueAnimatorRESTART 表示 从 头 开始 ， 

ValueAnimatorREVERSE 表示 倒 过 来 开始 。 默 认为 ValueAnimator.RESTART. 
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setRepeatCount: 设置 重播 次 数 。 默 认为 0 表示 只 播放 一 次 。 

setDuration: 设置 动画 的 持续 时 间 。 单 位 毫秒 。 

setlnterpolator: 设置 动画 的 插值 器 。 

setEvaluator: 设置 动画 的 估 值 器 。 

start: 开始 播放 动画 。 

cancel: 取消 播放 动画 。 

end: 结束 播放 动画 。 

pause: 暂停 播放 动画 。 

resume: 恢复 播放 动画 。 

reverse: 倒 过 来 播放 动画 。 

isRunning: 判断 动画 是 否 在 播放 。 注 意 ， 暂 停 时 ，isRunning 方法 仍然 返回 true, 
isPaused: 判断 动画 是 否 被 暂停 。 

isStarted: 判断 动画 是 否 已 经 开始 。 注 意 ， 曾 经 播放 与 正在 播放 都 算 已 经 开始 。 
addListener: 添加 动画 监听 器 ， 需 实现 接口 AnimatorListener 的 4 个 方法 。 

> onAnimationStart: 在 动画 开始 播放 时 触发 。 

> onAnimationEnd: 在 动画 结束 播放 时 触发 。 

> onAnimationCancel: 在 动画 取消 播放 时 触发 。 

> onAnimationRepeat: 在 动画 重播 时 触发 。 


removeListener: 移出 指定 的 动画 监听 器 。 
removeAllListeners: 移出 所 有 动画 监听 器 。 


下 面 是 使 用 属性 动画 的 代码 : 


public class ObjectAnimActivity extends AppCompatActivity { 


private ImageView iv object anim; 
private ObjectAnimator alphaAnim, translateAnim, scaleAnim, rotateAnim, clipAnim; 


(@Override 

protected void onCreate(Bundle savedInstanceState) í 
Super.onCreate(savedInstanceState); 
setContentView(R.layout.activity object anim); 
iv object anim = (ImageView) findViewById(R.id.iv object anim); 
initAnim(); 
initObjectSpinner(); 

h: 

private void initAnim() { 
alphaAnim = ObjectAnimator.ofFloat(iv object anim, "alpha", 1f, 0.1f, 1f); 
translateAnim = ObjectAnimator.ofFloat(iv object anim, "translationX", Of, -200f, Of, 200f, 0f); 
scaleAnim = ObjectAnimator.ofFloat(iv object anim, "scaleY", 1f, 0.5f, 1f); 
rotateAnim = ObjectAnimator.ofFloat(iv object anim, "rotation", Of, 360f, 0f); 








private void initObjectSpinner() í 
ArrayAdapter<String> objectAdapter = new ArrayAdapter<String>(this, 
R.layoutitem select, objectArray); 
Spinner sp object = (Spinner) findViewById(R.id.sp object); 
sp_object.setPrompt(" 请 选择 属性 动画 类 型 "); 
sp object.setAdapter(objectA dapter); 
sp object.setOnItemSelectedListener(new ObjectSelectedListener()); 
sp object.setSelection(0); 
} 
private String[] objectArray={" 灰 度 动画 ", "平移 动画 ", "缩放 动画 ", "旋转 动画 ", "Arai; 
class ObjectSelectedListener implements OnltemSelectedListener í 
public void onltemSelected( AdapterView<?> arg0, View argl, int arg2, long arg3) { 





showAnimation(arg2); 
Í 
public void onNothingSelected(AdapterView<?> arg0) í 
j 


i 


(a) TargetApi(Build. VERSION CODES.JELLY BEAN MR2) 
private void showAnimation(int type) í 
ObjectAnimator anim = null; 
if (type == 0) ( 
anim = alphaAnim; 
) else if (type = 1) í 
anim = translateAnim; 
) else if (type == 2) í 
anim — scaleAnim; 
} else if (type == 3) { 
anim — rotateAnim; 
) else if (type = 4) í 
if (Build. VERSION.SDK INT >= Build. VERSION CODES.JELLY BEAN MR2) { 
int width = iv object anim.getWidth(); 
intheight — iv object anim.getHeight(); 
clipAnim = ObjectAnimator.ofObject(iv object anim, "clipBounds", 
new RectEvaluator(), new Rect(0.0,width,height), 
new Rect(width/3,height/3,width/3*2,height/3*2), 
new Rect(0,0,width,height)); 
anim = clipAnim; 


) else ( 
Toast.makeText(this, 
"裁剪 动画 要 求 Android 为 43 以 上 版 本 ", ToastLENGTH SHORT ).show(); 
return; 
b 








Android Studio 开发 实战 :从 零 基 础 到 App 上线 





if (anim != null) í 
anim.setDuration(3000); 
anim.start(); 


} 

在 上 述 代码 演示 的 属性 动画 中 ， 补 间 动 画 已 经 实现 的 效果 就 不 再 给 出 图 示 了 ， 补 间 动 画 
未 实现 的 裁剪 动画 效果 如 图 12-22 和 图 12-23 所 示 。 其 中 ， 图 12-22 所 示 为 裁剪 即将 开始 时 的 
画面 ， 图 12-23 所 示 为 裁剪 过 程 中 的 画面 。 





animation animation 


属性 动画 类 型 : RIIE 





图 12-22 ”裁剪 动画 即将 开始 图 12-23 ”裁剪 动画 正在 播放 
12.3.2 ”属性 动画 组 合 


补 间 动 画 可 以 通过 集合 动画 AnimationSet 组 装 多 种 动画 效果 ， 属 性 动画 也 有 类 似 的 做 法 ， 
即 通过 属性 动画 组 合 AnimatorSet 组 装 多 种 属性 动画 。 
AnimatorSet 虽然 与 ObjectAnimator 都 是 继承 自 Animator, 但 是 两 者 的 使 用 方法 略 有 出 入 ， 
主要 是 属性 动画 组 合 少 了 部 分 方法 。 下 面 是 AnimatorSet 的 常用 方法 。 
e setDuration: 设置 动画 组 合 的 持续 时 间 。 单 位 毫秒 。 
e setlnterpolator: 设置 动画 组 合 的 插值 器 。 
e play: 设置 当前 动画 . 该 方法 返回 一 个 AnimatorSet.Builder 对 象 ， 可 对 该 对 象 调用 组 装 方 
法 添加 新 动画 ， 从 而 实现 动画 组 装 功能 。 下 面 是 Builder 的 组 装 方法 说 明 。 
> with: 指定 该 动画 与 当前 动画 一 起 播放 。 
> before: 指定 该 动画 在 当前 动画 之 前 播放 。 
> after: 指定 该 动画 在 当前 动画 之 后 播放 。 
start: 开始 播放 动画 组 合 。 
pause: 暂停 播放 动画 组 合 。 
resume: 恢复 播放 动画 组 合 。 
cancel: 取消 播放 动画 组 合 。 








e end: 结束 播放 动画 组 合 。 

e isRunning: 判断 动画 组 合 是 否 在 播放 。 

e isStarted: 判断 动画 组 合 是 否 已 经 开始 。 

下 面 是 使 用 属性 动画 组 合 的 代码 : 

private void initAnim() ( 

ObjectAnimator anim1 = ObjectAnimator.ofFloat(iv object group, "translationX", Of, 100f); 
ObjectAnimator anim2 = ObjectAnimator.ofFloat(iv object group, "alpha", 1f, 0.1f, 1f, 0.5f, 1f); 
ObjectAnimator anim3 = ObjectAnimator.ofFloat(iv object group, "rotation", 0f 360f); 
ObjectAnimator anim4 = ObjectAnimator.ofFloat(iv object group, "scaleY", 1f, 0.5f, 1f); 
ObjectAnimator anim5 = ObjectAnimator.ofFloat(iv object group, "translationX", 100f, 0f); 
animSet = new AnimatorSet(); 
AnimatorSet.Builder builder = animSet.play(anim2); 
/animl 先 执行 ， 然 后 再 同步 执行 nim2、anim3、anim3， 最 后 执行 anim5 
builder.with(anim3).with(anim4).after(anim1 ).before(anim5); 





animSet.setDuration(4500); 
animSet.start(); 
1 
属性 动画 组 合 的 演示 效果 如 图 12-24 和 图 12-25 所 示 。 其 中 ， 图 12-24 所 示 为 动画 组 合 开 
始 播放 不 久 的 画面 ， 图 12-25 所 示 为 动画 组 合 播放 过 程 中 的 画面 。 
animation 
图 12-24 ”属性 动画 组 合 开始 播放 图 12-25 属性 动画 组 合 正在 播放 


12.3.3 ”插值 器 和 估 值 器 


前 面 在 介绍 补 间 动 画 与 属性 动画 时 提 到 了 插值 器 ， 属 性 动画 还 提 到 了 估 值 器 ， 因 为 插值 
器 和 估 值 器 是 相互 关联 的 ， 所 以 放 到 一 起 介绍 。 

插值 器 用 来 控制 属性 值 的 变化 速率 ， 也 可 以 理解 为 动画 播放 的 速度 ， 默 认 是 匀速 播放 。 
要 给 动画 播放 指定 某 种 速率 形式 ， 调 用 setInterpolator 方法 设置 对 应 的 插值 器 实现 类 即 可 ， 无 
论 是 补 间 动 画 、 集 合 动画 、 属 性 动画 ， 还 是 属性 动画 组 合 ， 都 可 以 设置 插值 器 。 插 值 器 实现 类 
的 说 明 见 表 12-4。 
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表 12-4 ”插值 器 实现 类 的 说 明 
































插值 器 的 实现 类 说 明 

LinearInterpolator 匀速 插值 器 

AccelerateInterpolator 加 速 插值 器 

DecelerateInterpolator 减速 插值 器 

AccelerateDeceleratelnterpolator | 落水 插值 器 ， 即 前 半 段 加 速 、 后 半 段 减速 

AnticipateInterpolator 射箭 插值 器 ， 后 退 几 步 再 往 前 冲 

OvershootInterpolator 回旋 插值 器 ， 冲 过 头 再 归 位 

AnticipateOvershootInterpolator | 射箭 回旋 插值 器 ， 后 退 几 步 再 往 前 冲 ， 冲 过 头 再 归 位 

Bouncelnterpolator 震荡 插值 器 ， 类 似 皮球 落地 《落地 后 会 弹 起 几 次 ) 

CycleInterpolator 钟 摆 插 值 器 ， 以 开始 位 置 为 中 线 而 晃动 (类 似 摇摆 动画 , 开始 位 置 与 结束 位 





置 的 距离 就 是 摇摆 的 幅度 ) 


估 值 器 专用 于 属性 动画 ， 主 要 描述 该 属性 的 数值 变化 要 采用 什么 单位 ， 比 如 整 型 数 的 渐 
变数 值 要 取 整 ， 颜 色 的 渐变 数值 为 ARGB 格式 的 颜色 对 象 ， 矩 形 的 渐变 数值 为 Rect 对 象 等 。 
要 给 属性 动画 设置 估 值 器 ， 调 用 属性 动画 对 象 的 的 setEvaluator 方法 即 可 。 估 值 器 实现 类 的 说 








明 见 表 12-5。 
表 12-5 ” 估 值 器 实现 类 的 说 明 
估 值 器 的 实现 类 说 明 
IntEvaluator 整 型 估 值 器 
FloatEvaluator 浮 点 型 估 值 器 
ArgbEvaluator 颜色 估 值 器 
RectEvaluator 和 矩形 估 值 器 





- 般 情 况 下 ， 无 须 单独 设置 属性 动画 的 估 值 器 ， 使 用 系统 默认 的 估 值 器 即 可 。 但 是 如 果 
属性 类 型 不 是 int、float、argb 三 种 ， 只 能 通过 ofObject 方法 构造 属性 动画 对 象 ， 就 必须 指定 
该 属性 的 估 值 器 , 否则 系统 不 知道 如 何 计算 渐变 属性 值 。 为 方便 记忆 属性 动画 的 构造 方法 与 估 
值 器 的 关联 关系 ， 表 12-6 列 出 了 两 者 之 间 的 对 应 关系 。 


表 12-6 属性 类 型 与 估 值 器 的 对 应 关系 





属性 动画 的 构造 方法 | 估 值 器 





对 应 的 属性 说 明 























oflnt IntEvaluator 整 型 类 型 的 属性 
ofFloat | FloatEvaluator | 大 部 分 状态 属性 ， 如 alpha, rotation, scaleY, translationX, textSize 等 
ofArgb | ArgbEvaluator | 颜色 ， 如 backgroundColor、textColor 等 











ofObject RectEvaluator 











裁 前 范围， 如 clipBounds 





下 面 是 在 属性 动画 中 运用 插值 器 和 估 值 器 的 代码 : 


public class InterpolatorActivity extends AppCompatActivity implements AnimatorListener í 


private TextView tv_interpolator; 














private ObjectAnimator animAcce, animDece, animLinear, animBounce; 


@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity interpolator); 
tv interpolator = (TextView) find ViewById(R.id.tv interpolator); 
initAnimator(); 
initInterpolatorSpinner(); 

j 


private void initInterpolatorSpinner() í 

ArrayAdapter-String? interpolatorAdapter = new ArrayAdapter-String-(this, 
R.layout.item select, interpolatorArray); 

Spinner sp interpolator = (Spinner) findViewById(R.id.sp interpolator); 
sp_interpolator.setPrompt(" 请 选择 插值 器 类 型 "); 
sp interpolator.setAdapter(interpolatorA dapter); 
sp interpolator.setOnItemSelectedListener(new InterpolatorSelectedListener()); 
sp interpolator.setSelection(0); 

j 


private String[] interpolatorArray-( 
"背景 色 + 加 速 插值 器 + 颜色 估 值 器 ", "旋转 + 减速 插值 器 + 浮 点 型 估 值 器 "， 
"裁剪 + 匀速 插值 器 + 矩形 估 值 器 ", "文字 大 小 + 震荡 插值 器 + 浮 点 型 估 值 器 "}; 
class InterpolatorSelectedListener implements OnltemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) í 
showlnterpolator(arg2); 
I 


public void onNothingSelected(AdapterView<?> arg0) í 
j 
j 


private void initAnimator() f 
animAcce = ObjectAnimator.ofArgb(tv interpolator, "backgroundColor", Color.RED, Color. LTGRAY ); 
animAcce.setInterpolator(new AccelerateInterpolator()); 
animAcce.setEvaluator(new ArgbEvaluator()); 


animDece = ObjectAnimator.ofFloat(tv interpolator, "rotation", Of, 360f); 
animDece.setInterpolator(new DecelerateInterpolator()); 
animDece.setEvaluator(new FloatEvaluator()); 


animBounce = ObjectAnimator.ofFloat(tv interpolator, "textSize", 20f, 60f); 
animBounce.setInterpolator(new BouncelInterpolator()); 
animBounce.setEvaluator(new FloatEvaluator()); 
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(&/TargetApi(Build. VERSION CODES.JELLY BEAN MR2) 
private void showInterpolator(int type) í 
ObjectAnimator anim = null; 
if (type — 0) ( 
anim = animAcce; 
} else if (type = 1) í 
anim = animDece; 
} else if (type —2) í 
if (Build. VERSION.SDK INT >= Build. VERSION CODES.JELLY BEAN MR2) { 
int width —tv interpolator.getWidth(); 
int height —tv interpolator.getHeight(); 
animLinear = ObjectAnimator.ofObject(tv interpolator, "clipBounds", 
new RectEvaluator(), new Rect(0,0,width,height), 
new Rect(width/3,height/3,width/3*2,height/3*2), 
new Rect(0,0,width,height)); 
animLinear.setInterpolator(new Linearlnterpolator()); 
anim = animL inear; 


) else í 
Toast.makeText(this, 
"矩形 估 值 器 要 求 Android 为 4.3 以 上 版 本 ", ToasLLENGTH. SHORT).show(); 
return; 
j 


) else if (type = 3) í 
anim — animBounce; 


J 

if (anim != null) í 
anim.setDuration(2000); 
anim.start(); 

$ 


} 

插值 器 和 估 值 器 的 演示 效果 如 图 12-26 和 图 12-27 所 示 。 其 中 , 图 12-26 所 示 为 文字 大 小 变 
大 时 的 画面 ， 图 12-27 所 示 为 文字 大 小 变 小 时 的 画面 。 此 处 采用 的 是 震荡 插值 器 ， 由 于 截图 无 
法 准确 反映 震荡 的 动画 效果 ， 因 此 建议 读者 自行 编译 并 运行 测试 代码 ， 这 样 会 有 更 直观 的 感受 。 





BARRE: 文字 大 小 + 震荡 插值 器 + 浮 点 型 估 “ 插值 器 类 型 : 文字 大 小 + 震荡 插值 器 + 浮 点 型 估 “ 


看 看 插值 器 的 效果 是 什么 看 看 插值 器 的 效果 是 什么 














图 12-26 震荡 插值 器 开始 播放 图 12-27 震荡 插值 器 即将 结束 

















124 动画 的 实现 手段 


本 节 介 绍 动画 技术 常见 的 3 种 实现 手段 ， 包 括 以 帧 动画 为 代表 的 延 时 重 绘 方式 、 以 补 间 
动画 和 属性 动画 为 代表 的 设置 状态 参数 方式 以 及 为 解决 拖 忠 卡 顿 问题 而 采用 的 滚动 器 。 


12.4. 使 用 延 时 重 绘 





延 时 重 绘 是 最 基本 的 动画 实现 手段 ， 代 表 技术 为 帧 动画 ， 每 隔 若 干 毫秒 就 用 新 图 片 换 掉 
原 图 片 ， 人 了 眼看 过 去 仿佛 画面 动 起 来 了 。 
当然 ， 除 了 帧 动画 ， 还 有 不 少 地 方 采 用 延 时 重 绘 技术 ， 比 如 第 6 章 的 圆 弧 进度 动画 、 第 7 
章 的 Banner 指示 器 等 ， 它 们 都 是 连续 调用 onDraw 或 dispatchDraw 方法 实现 动画 效果 。 尽 管 
这 方面 读者 已 经 比较 熟悉 ， 不 过 为 加 深 对 该 手段 的 理解 ， 不 妨 再 动手 实现 一 个 饼 图 动画 。 
下 面 是 饼 图 动画 的 参考 代码 片段 : 
(@Override 
protected void onDraw(Canvas canvas) í 
super.onDraw(canvas); 
if (mRunning = true) í 
int width = getMeasuredWidth(); 
int height = getMeasuredHeight(); 
int diameter = Math.min(width, height); 
RectF rectf = new RectF((width - diameter) / 2, (height - diameter) / 2, 
(width + diameter) / 2, (height + diameter) / 2); 
canvas.drawArc(rectf, 0, mDrawingAngle, true, mPaint); 





ji 
} 
private Runnable mRefresh = new Runnable() { 
@Override 
public void run() { 
mDrawingAngle += mIncrease; 
if (mDrawingAngle <= mEndAngle) { 
postInvalidate(); 
mHandler.postDelayed(this, mInterval); 
j else í 
mRunning = false; 
; 
] 


E 


饼 图 动画 的 播放 效果 如 图 12-28 和 图 12-29 所 示 。 其 中 ， 图 12-28 所 示 为 饼 图 动画 开始 播 
放 时 的 画面 ， 图 12-29 所 示 为 饼 图 动画 即将 结束 时 的 画面 。 
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E1228 饼 图 动画 开始 播放 图 12-29 饼 图 动画 即将 结束 
124.2 ”设置 状态 参数 


设置 状态 参数 是 最 常见 的 动画 实现 手段 ， 代 表 技 术 为 补 间 动 画 和 属性 动画 ， 通 过 持续 改 
变 视 图 的 状态 属性 数值 让 该 视图 蹦 起 来 、 跳 起 来 。 
虽然 通过 属性 动画 可 实现 大 多 数 状态 变更 动画 ， 但 是 属性 动画 要 求 有 明确 的 初始 状态 值 
和 结束 状态 值 , 如 果 这 些 起 止 状 态 值 无 法 确定 ,中间 还 要 加 入 其 他 运算 ， 属 性 动画 就 无 法 胜任 
如 此 复杂 的 要 求 ， 只 能 自己 实现 状态 变更 动画 了 。 
举 个 例子 ， 经 常 看 朋友 圈 动 态 ， 有 的 动态 内 容 较 多 只 展示 前 面 一 段 ， 如 果 用 户 想 看 完整 
的 需要 点 击 展 开动 态 ,看 完 后 再 点 击 收缩 动态 。 这 样 整个 页 面 的 动态 列表 就 会 比较 均衡 ， 不 会 
出 现 个 别 动态 占用 大 片 屏幕 的 情况 。 查 看 博客 的 文章 列表 也 一 样 , 一 开始 只 展示 文章 开头 的 几 
行内 容 ， 有 需要 时 再 点 击 显示 全 篇 文章 。 
点 击 展开 动态 ， 再 点 击 收缩 动态 ， 展 开 与 收缩 动画 其 实 是 不 停 地 变更 视图 高 度 。 如 果 动 
态 内 容 初 始 展示 3 行文 字 , 初始 高 度 就 是 每 行文 字 的 高 度 乘 以 3， 展开 后 的 高 度 就 是 每 行 高 度 
乘 以 总 行 数 。 有 了 视图 高 度 的 起 始 值 和 终止 值 就 可 以 实现 动画 效果 了 。 
下 面 是 展开 动画 的 参考 代码 片段 : 
@Override 
public void onClick(View v) { 
if (v.getld() = R.id.ll content) í 
bSelected = !bSelected; 
tv content.clearAnimation(); 
final int deltaValue; 
final int startValue = tv content.getHeight(); 
if (bSelected) { 
deltaValue — tv content.getLineHeight() * tv content.getLineCount() - start Value; 
} else { 
deltaValue = tv_content.getLineHeight() * mNormalLines - startValue; 
; 


- 478 - 
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Animation animation = new Animation() í 
protected void apply Transformation(float interpolatedTime, Transformation t) í 
tv content.setHeight((int) (start Value + delta Value * interpolatedTime)); 
; 
n 
animation.setDuration(500); 
tv content.startÀnimation(animation); 


5 


展开 动画 的 播放 效果 如 图 12-30 和 图 12-31 所 示 。 其 中 ， 图 12-30 所 示 为 点 击 文本 区 域 准 
备 播放 展开 动画 时 的 画面 ， 图 12-31 所 示 为 展开 动画 即将 结束 时 的 画面 。 
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遇 到 爱 你 的 人 ， 学 会 感恩 。 遇 到 你 爱 的 遇 到 爱 你 的 人 ， 学 会 感恩 。 遇 到 你 爱 的 
人 ， 学 会 付出 ; 遇 到 你 恨 的 人 ， 学 会 原 人 ， 学 会 付出 ; 遇 到 你 恨 的 人 ， 学 会 原 


谅 。 遇 到 恨 你 的 人 ， 学 会 道歉 ; 遇 到 欣赏 你 谅 。 遇 到 恨 你 的 人 ， 学 会 道歉 ; 遇 到 欣赏 你 
的 人 ， 学 会 笑 纳 。 遇 到 你 欣赏 的 人 , 学 会 赞 


~ Th hA fm hn 





图 12-30 展开 动画 准备 播放 图 12-31 展开 动画 即将 结束 
12.4.8 ”滚动 器 Scroller 


第 11 章 的 实战 项 目 通过 移动 手势 拖 忠 图 片 到 指定 位 置 ， 拖 忠 后 直接 在 新 位 置 重 绘 整个 图 
JP, 不 知道 读者 有 没有 发 现 ， 这 种 拖 忠 方式 的 画面 存在 卡 顿 现象 。 因 为 根据 人 眼 的 机 理 , 每 秒 
连续 播放 20 帧 图 片 才 不 易 感 觉 到 画面 卡 顿 , 而 拖 忠 重 绘 的 做 法 频率 绝对 小 于 每 秒 20 次 , 所 以 
自然 会 出 现 画 面 卡 顿 。 

为 解决 拖 电 卡 顿 的 问题 ，Android 提供 了 滚动 器 Scroller, 38 Scroller 可 以 实现 平滑 滚动 
的 效果 。 下 面 是 Scroller 的 常用 方法 说 明 。 


e startScroll: 设置 开始 滑动 的 参数 ,包括 起 始 的 横 纵 坐 标 、 横 纵 偏 移 量 和 滑动 的 持续 时 间 。 
e computeScrollOffset: 计算 滑动 偏 移 量 。 返 回 值 可 判断 滑动 是 否 结束 ， 返 回 fasle + F? 
动 结束 ， 返 回 true 表示 还 在 滑动 中 。 

getCurrX: 获得 当前 的 横 坐 标 。 

getCurrY: 获得 当前 的 纵 坐标 。 

getDuration: 获得 滑动 的 持续 时 间 。 

forceFinished: 强行 停止 滑动 。 

isFinished: 判断 滑动 是 否 结束 。 返 回 fale 表示 还 未 结束 ， 返 回 true 表示 滑动 结束 。 


该 方法 与 computeScrollOffset 的 区 别 在 于 : 


(1) computeScrollOffset 内 部 计算 偏 移 量 ， 而 isFinished 只 返回 标志 不 做 其 他 处 理 。 
(2) computeScrollOffset 返回 fasle 表示 滑动 结束 ， 而 isFinished 返回 true 表示 滑动 结束 。 
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虽然 滚动 器 提供 了 滑动 的 相关 计算 函数 ， 但 是 并 不 能 直接 滑动 视图 。 因 为 Scroller 是 一 个 
运算 模拟 器 , 根据 时 间 的 流逝 计算 横 纵 坐标 偏 移 ， 要 想 让 视图 真正 动 起 来 , 还 得 调用 视图 自身 
的 滑动 方法 处 理 滑动 操作 ， 即 调用 scrollTo 和 scrollBy 两 个 方法 。 

e scrollTo: 将 视图 滑动 到 指定 坐标 位 置 。 

e scrollBy: 将 视图 滑动 指定 偏 移 量 。 查 看 源码 会 发 现 scrollBy 方法 内 部 就 是 调用 scrollTo 

方法 ， 当 然 得 先 给 当前 坐标 加 上 偏 移 量 ， 从 而 得 到 滑动 后 的 绝对 坐标 。 

下 面 是 使 用 滚动 器 的 参考 代码 ; 

public class ScrollTextView extends TextView í 

private Scroller mScroller; 





public ScrollTextView(Context context) í 
this(context, null); 


j 


public ScrollTextView(Context context, AttributeSet attrs) í 
super(context, attrs); 
mScroller = new Scroller(context); 


1 


public void smoothScrollTo(int fx, int fy) í 
int dx = fx - mScroller.getFinalX(); 
int dy = fy - mScroller.getFinalY(); 
smoothScrollBy(dx, dy); 

j 


public void smoothScrollBy(int dx, int dy) í 
/ 设置 滚动 偏 移 量 ， 注 意 正 数 是 往 左 深 、 往 上 深 ， 负 数 才 是 往 右 深 、 往 下 深 
mScroller.startScroll(mScroller.getFinalX(), mScroller.getFinalY(), -dx, -dy); 
/ 调用 invalidate 方法 才能 保证 computeScroll 方法 被 调用 
invalidate(); 
} 


@Override 
public void computeScroll() í 
if (mScroller.computeScrollOffset()) í // 先 判断 mScroller 滚动 是 否 完成 
scrollTo(mScroller.getCurrX(), mScroller.getCurrY()); /调用 scrollTo 方法 完成 实际 滚动 
postInvalidate(); // 刷新 页 面 
] 
super.computeScroll(); 
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滚动 器 的 演示 效果 如 图 12-32 和 图 12-33 所 示 。 其 中 ， 图 12-32 所 示 为 视图 滚动 开始 前 的 
画面 ， 图 12-33 所 示 为 视图 滚动 结束 后 的 画面 。 单 看 截图 不 方便 观察 动画 效果 ， 建 议 读者 自己 
运行 代码 查看 效果 图 。 


animation animation 


您 拖 动 我 哈 





图 12-32 视图 尚未 开始 滚动 图 12-33 ”视图 滚动 已 经 结束 
12.5 KRMH: 仿 QQ 空间 的 动感 影集 


动画 可 以 做 得 千变万化 、 很 酷 很 炫 ， 故 而 常用 于 展示 具有 纪念 意义 的 组 图 ， 比 如 婚纱 照 、 
亲子 照 、 艺 术 照 等 。 这 方面 做 得 比较 好 、 使 用 比较 广泛 的 当 数 QQ 空间 的 动感 影集 ， 用 户 添加 
-组 图 片 , 动感 影集 便 给 每 张 图 片 泻 染 不 同 的 动画 效果 , 让 原本 静止 的 图 片 变 得 活泼 起 来 ， 辅 
以 各 种 精致 的 动画 特效 ， 营 造 一 种 赏心悦目 的 感觉 。 本 章 以 “ 仿 QQ 空间 的 动感 影集 ”为 实战 
项 目 ， 结 合 本 章 的 动画 技术 实现 开发 者 自己 的 动感 影集 。 


12.5.1 设计 思 


动感 影集 的 目的 是 使 用 动画 技术 呈现 前 后 图 片 的 动 
态 切换 效果 ， 用 到 的 动画 必须 承上启下 ， 而 且 要 求 具备 
- 定 的 视觉 美感 。 以 这 样 的 标准 来 衡量 ， 目 前 适用 于 动 
感 影集 的 动画 种 类 不 算 多 ， 下 面 都 拿 来 练 练 手 。 动 感 影 
集 的 播放 效果 如 图 12-34 所 示 ， 很 明显 这 是 一 个 包含 旋 
转动 画 在 内 的 集合 动画 。 

当然 ， 实 战 项 目的 动感 影集 不 仅 采 用 集合 动画 ， 还 
包括 其 他 种 类 动画 ， 读 者 不 妨 先 列举 一 部 分 ， 看 看 有 哪 
些 能 够 应 用 在 动感 影集 中 。 下 面 是 笔者 罗列 的 部 分 影集 
动画 技术 。 图 12-34 动感 影集 中 的 集合 动画 效果 


CD 淡 入 淡出 动画 : 用 于 前 后 两 张 图 片 的 渐变 切换 。 
(2) 灰 度 动画 : 用 于 从 无 到 有 渐变 显示 一 张 图 片 。 
Go 平移 动画 : 用 于 把 上 层 图 片 抽 离 当 前 视图 。 
XD 缩放 动画 : 用 于 逐步 缩小 并 隐没 上 层 图 片 。 
(5) 旋转 动画 : 用 于 将 上 层 图 片 思 离 当前 视图 。 

画 

Hj 


animation 








(6) 裁剪 动画 : 用 于 把 上 层 图 片 逐步 裁剪 完 。 
CD 其 余 动画 : 更 多 动画 特效 切换 ， 包 括 百 叶 窗 动画 、 马 赛 克 动画 等 。 
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动画 技术 用 起 来 不 难 ， 关 键 要 用 好 ， 只 有 用 到 位 才能 让 你 的 App RREK ERE. 
12.5.2 ”小 知识 : 画布 的 绘图 层次 


本 书 到 目前 为 止 ， 画 布 Canvas 上 的 绘图 操作 都 是 在 同一 个 图 层 上 进行 的 。 这 就 意味 着 如 
果 存 在 重 且 区域, 后 面 绘制 的 图 形 就 必然 覆盖 前 面 的 图 形 。 但 绘图 是 比较 复杂 的 事情 , 不 是 直 
接 履 盖 这 人 么 简单 ， 有 些 特殊 的 绘图 操作 往往 需要 做 与 、 或 、 非 运算 ， 如 此 才能 实现 百 变 的 图 像 
特效 。 
Android 给 画布 的 图 层 显示 制定 了 许多 规则 ， 详 细 的 图 层 显示 规则 见 表 12-7。 表 中 的 上 层 
指 的 是 后 面 绘制 的 图 形 Src， 下 层 指 的 是 前 面 绘制 的 图 形 Dst。 
表 12-7 ”图 层 模 式 的 取 值 说 明 























PorterDuff.Mode 类 的 图 层 模式 说 明 

CLEAR 不 显示 任何 图 形 

SRC 只 显示 上 层 图 形 

DST 只 显示 下 层 图 形 

SRC_OVER 按 通 常情 况 显 示 ， 即 重 麦 部 分 由 上 层 遮 盖 下 层 
DST_OVER 重合 部 分 由 下 层 遮 盖 上 层 ， 其 余部 分 正常 显示 
SRC IN REREAD LARW 

DST IN Hoe fe FIZEUE 

SRC OUT Hos EJZEUEITIK E PENA 

DST OUT RER FJAEUEITIK E PENA 

SRC ATOP 只 显示 上 层 图 形 区 域 ， 但 重 登 部 分 显示 下 层 图 形 
DST_ATOP 只 显示 下 层 图 形 区 域 ， 但 重 辣 部 分 显示 上 层 图 形 
XOR 不 显示 重 登 部 分 ， 其 余部 分 正常 显示 

DARKEN 重 从 部 分 按 颜料 混合 方式 加 深 ， 其 余部 分 正常 显示 
LIGHTEN 重合 部 分 按 光 照 重合 方式 加 亮 ， 其 余部 分 正常 显示 
MULTIPLY 只 显示 重 辣 部 分 ， 且 重 闪 部 分 的 颜色 混合 加 深 
SCREEN 过 滤 重 又 部 分 的 深 色 ， 其 余部 分 正常 显示 





这 些 图 层 规则 的 文字 说 明 有 点 令 人 费解 , 还 是 看 画面 效 
果 比 较 直 观 。 如 图 12-35 所 示 ， 圆 圈 是 先 绘制 的 图 形 ， 正 方 
形 是 后 绘制 的 图 形 ， 图 例 展示 了 运用 不 同 规则 时 的 显示 画 
面 。 合 理 运用 图 层 规则 可 以 实现 酷 炫 的 动画 效果 ， 比 如 百叶 
窗 动 画 、 马 赛 克 动 画 等 。 

要 想 在 画布 中 使 用 图 层 规则 ， 就 要 调用 画布 对 象 的 
setXfermode 方法 ， 并 指定 相应 的 图 层 模式 。 下 面 是 百叶 窗 
视图 的 代码 ， 其 中 采用 了 DST_IN 模式 : 
























































12-35 各 种 图 层 规则 的 画面 效果 








public class ShutterView extends View í 


private final static String TAG = "ShutterView"; 

private Context mContext; 

private Paint mPaint; 

private int mOriention = LinearLayout. HORIZONTAL; 
private int mLeafCount — 10; 

private PorterDuff. Mode mMode — PorterDuff.Mode.DST IN; 
private Bitmap mBitmap; 

private int mRatio — 0; 


public ShutterView(Context context) í 
this(context, null); 


J 


public ShutterView(Context context, AttributeSet attrs) í 
super(context, attrs); 
mContext = context; 
mPaint = new Paint(); 
j 
public void setOriention(int oriention) í 
mOriention = oriention; 


} 


public void setLeafCount(int leaf count) í 
mLeafCount = leaf count; 


j 

public void setMode(PorterDuff.Mode mode) í 
mMode = mode; 

j 


public void setImageBitmap(Bitmap bitmap) í 
mBitmap = bitmap; 


j 


public void setRatio(int ratio) í 
mRatio = ratio; 
invalidate(); 

i 


(Q'SuppressLint("DrawAllocation") 
@Override 
protected void onDraw(Canvas canvas) { 
super.onDraw(canvas); 
if (mBitmap = null) { 





Android Studio RËRA: 从 零 基础 到 App 上 线 





return; 
J 
int width = getMeasuredWidth(); 
int height = getMeasuredHeight(); 
canvas.drawColor(Color. TFRANSPARENT); 
/ OERA rp t 
Bitmap mask = Bitmap.createBitmap(width, height, mBitmap.getConfig()); 
Canvas canvasMask = new Canvas(mask); 
for (int i = 0; i < mLeafCount; i++) í 
if (mOriention == LinearLayout.HORIZONTAL) í 
int column width — (int) Math.ceil(width*1f / mLeafCount); 
int left = column width * i; 
int right = left + column width * mRatio / 100; 
canvasMask.drawRect(left, 0, right, height, mPaint); 
) else í 
introw height — (int) Math.ceil(height* 1 f / mLeafCount); 
int top = row height * i; 
int bottom = top + row height * mRatio / 100; 
canvasMask.drawRect(0, top, width, bottom, mPaint); 


J 

/ 设置 离 屏 缓 存 

int saveLayer = canvas.saveLayer(0, 0, width, height, null, Canvas.ALL SAVE FLAG); 
/ 绘制 目标 图 像 

Rect src = new Rect(0, 0, mBitmap.getWidth(), mBitmap.getHeight()); 

Rect dst = new Rect(0, 0, width, width*mBitmap.getHeight()/mBitmap.getWidth()); 
canvas.drawBitmap(mBitmap, src, dst, mPaint); 

/ 设置 混合 模式 〈 只 在 源 图 像 和 目标 图 像 相 交 的 地 方 绘制 目标 图 像 ) 
mPaint.setX fermode(new PorterDuffXfermode(mMode)); 

/ 再 绘制 src 源 图 

canvas.drawBitmap(mask, 0, 0, mPaint); 

/ 还 原 混合 模式 

mPaint.setX fermode(null); 

/ 还 原画 布 

canvas.restoreToCount(saveLayer); 


; 
百叶 窗 视 图 ShutterView 仅仅 是 一 个 静态 画面 ， 若 想 让 它 动 起 来 形成 百叶 窗 动画 还 得 利用 
属性 动画 渐进 设置 ratio 属性 ， 使 整个 百叶 窗 的 各 个 叶片 逐步 合 上 ， 从 而 实现 动画 特效 。 下 面 
是 百叶 窗 动画 的 代码 : 
public class ShutterActivity extends AppCompatActivity { 
private ShutterView sv_shutter; 














@Override 
protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity shutter); 
Sv shutter = (ShutterView) find ViewById(R.id.sv shutter); 
sv. shutter.setImageBitmap(BitmapFactory.decodeResource(getResources(), R.drawable.bdg03)); 
initShutterSpinner(); 
1 


private void initShutterSpinner() í 
ArrayAdapter<String> shutterAdapter = new ArrayAdapter<String>(this, 
R.layout.item_select, shutterArray); 
Spinner sp shutter = (Spinner) findViewById(R.id.sp_shutter); 
sp_shutter.setPrompt(" 请 选择 百叶 窗 动画 类 型 "); 
sp shutter.setAdapter(shutterAdapter); 
sp shutter.setOnItemSelectedListener(new ShutterSelectedListener()); 
sp shutter.setSelection(0); 


} 


private String[] shutterArray- ("gk °F EM", "水 平 十 叶 ", "水 平 二 十 时" 
"EHEM", "RE RE, "SEC |n 
class ShutterSelectedListener implements OnItemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) í 
sv. shutter.setOriention((arg2-3)?LinearLayout. HORIZONTAL:LinearLayout. VERTICAL); 
if(arg? = 0 || arg2 = 3) { 
sv. shutter.setLeafCount(5); 
} else if (arg? = 1 || arg2 = 4) ( 
sv. shutter.setLeafCount( 10); 
} else if (arg2 = 2 || arg2 == 5) í 
sv. shutter.setLeafCount(20); 


j 
ObjectAnimator anim = ObjectAnimator.ofInt(sv shutter, "ratio", 0, 100); 


anim.setDuration(3000); 

anim.start(); 
; 
public void onNothingSelected(AdapterView-?- arg0) í 
; 


j 


百叶 窗 动 画 的 播放 效果 如 图 12-36 和 图 12-37 所 示 。 其 中 ， 图 12-36 所 示 为 百叶 窗 动 画 开 
始 播放 时 的 画面 ， 图 12-37 所 示 为 百叶 窗 动 画 即 将 结束 播放 时 的 画面 。 
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百叶 窗 动画 样式 : 水 平 五 叶 百叶 窗 动画 样式 : 水 平 五 叶 


f 
: 
4 


图 12-36 百叶窗 动画 开始 播放 图 12-37 百叶 窗 动 画 即 将 结束 播放 
马赛 克 动 画 的 实现 原理 与 百叶 窗 动画 类 似 ， 只 是 在 绘制 图 片 遮 罩 时 选择 了 不 同 的 算法 ， 
其 余 步 骤 与 百叶 窗 动 画 是 一 样 的 。 马 赛 克 视图 的 MosaicView 代码 参见 本 书 的 下 载 资源 ， 马 赛 
克 动 画 的 播放 效果 如 图 12-38 和 图 12-39 所 示 。 其 中 ， 图 12-38 所 示 为 马赛 克 动 画 开始 播放 时 
的 画面 ， 图 12-39 所 示 为 马赛 克 动 画 即将 结束 播放 时 的 画面 。 
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马赛 克 动 画 样式 : 水 平 三 十 格 








图 12-38 马赛 克 动 画 开始 播放 图 12-39 马赛 克 动 画 即 将 结束 


12.5.3 ”代码 示例 


编码 与 测试 方面 需要 注意 以 下 两 点 : 

(1) 如 果 把 动画 描述 定义 在 XML 文件 中 ， 注 意 动 画 定义 文件 要 放 在 res/anim 目录 下 。 

(2) 测试 手机 的 Android 版 本 要 求 不 低 于 Android 4.3， 因 为 裁剪 动画 用 到 的 矩形 估 值 器 
RectEvaluator 是 在 Android 4.3 之 后 引入 的 。 

动感 影集 的 测试 挺 简 单 的 ， 无 须 什么 操作 流程 ， 只 要 静 静 欣赏 屏幕 上 的 动画 轮 播 即 可 。 
动感 影集 的 轮 播 效 果 如 图 12-40 一 图 12-45 所 示 。 其 中 ， 图 12-40 展示 了 灰 度 动画 ， 图 12-41 
展示 了 裁剪 动画 ， 图 12-42 展示 了 百叶 窗 动画 ， 图 12-43 展示 了 马赛 克 动 画 ， 图 12-44 展示 了 
淡 入 淡出 动画 ， 图 12-45 展示 了 平移 动画 。 
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正在 播放 灰 度 动画 正在 播放 裁剪 动画 











图 12-40 动感 影集 的 灰 度 动画 效果 
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图 12-42 ”动感 影集 的 百叶 窗 动画 效果 























片 。 另 




















源码 的 


基础 上 进行 改造 ， 使 其 更 贴近 真实 动感 影集 使 用 习惯 。 


图 12-44 ”动感 影集 的 淡 入 淡出 动画 效果 图 12-45 动感 影集 的 平移 动画 效果 
为 方便 演示 ， 动 感 影集 未 做 成 可 选择 图 片 文件 的 形式 ， 而 是 在 代码 中 





固定 了 几 张 演示 图 


外 ， 各 种 动画 的 执行 顺序 也 是 固定 的 ， 没 有 做 成 可 定制 动画 顺序 。 读 者 若 有 兴趣 ， 可 在 
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下 面 是 动感 影集 的 活动 页 面 代码 : 
public class YingjiActivity extends AppCompatActivity implements 


AnimatorListener, AnimationListener, OnClickListener í 
private RelativeLayout rl. yingji; 





private TextView tv anim title; 

private LayoutParams mParams; 

private ImageView view], view4, view5, view6; 

private ShutterView view2; 

private MosaicView view3; 

private int[] mImageArray = í 
R.drawable.bdg01, R.drawable.bdg02, R.drawable.bdg03, R.drawable.bdg04, R.drawable.bdg05, 
R.drawable.bdg06, R.drawable.bdg07, R.drawable.bdg08, R.drawable.bdg09, R.drawable.bdg10 

h 

private ObjectAnimator anim], anim2, anim3, anim4; 

private Animation translateAnim, setAnim; 

private int mDuration — 5000; 


(a Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity yingji); 
rl yingji = (RelativeLayout) findViewById(R.id.rl yingji); 
tv anim title = (TextView) findViewById(R.id.tv anim title); 
play Yingji(); 


private void initView() { 
mParams = new LayoutParams(LayoutParams.MATCH PARENT, LayoutParams. MATCH PARENT); 
viewl = new ImageView(this); // 灰 度 动画 和 裁剪 动画 
viewl.setLayoutParams(mParams); 
viewl.setImageResource(mImageArray[0]); 
view l.setScaleType(ScaleType.FIT START); 
viewl.setAlpha(0f); /百叶 窗 动 画 
view2 = new ShutterView(this); 
view2.setLayoutParams(mParams); 
view2.setImageBitmap(BitmapFactory.decodeResource(getResources(), mImageAr ray[1])); 
view2.setMode(PorterDuff.Mode.DST OUT); 
view3 = new MosaicView(this); /马赛 克 动 画 
view3.setLayoutParams(mParams); 
view3.setImageBitmap(BitmapFactory.decodeResource(getResources(), mImageArray[?])); 
view3.setMode(PorterDuff.Mode.DST OUT); 
view3.setRatio(-5); 
view4 = new ImageView(this); // 淡 入 淡出 动画 








D 


view4.setLayoutParams(mParams); 
view4.setImageResource(mImageArray[3]); 
view4.setScaleType(ScaleType.FIT START); 
viewS = new ImageView(this) /平移 动画 
viewS.setLayoutParams(mParams); 
viewS.setImageResource(mImageArray[5]); 
viewS.setScaleType(ScaleType.FIT START); 
view6 = new ImageView(this); —//fE-&zJjiBii 
view6.setLayoutParams(mParams); 
view6.setImageResource(mImageArray[6]); 
view6.setScaleType(ScaleType.FIT START); 


private void playYingji() í 


} 


rl yingji.removeAllViews(); 

initView(); 

rl yingji.addView(view); 

animl = ObjectAnimator.ofFloat(view  , "alpha", Of, 1f); 
animl.setDuration(mDuration); 

anim] .addListener(this); 

animl .start(); 


@Override 
public void onAnimationStart(Animator animation) { 


j 


if (animation.equals(animl)) í 
tv_anim_title.setText(" 正 在 播放 灰 度 动 画 "); 

} else if (animation.equals(anim2)) { 
tv_anim_title.setText(" 正 在 播放 裁剪 动画 "); 

} else if (animation.equals(anim3)) { 
tv_anim_title.setText(" 正 在 播放 百叶 窗 动 画 "); 

} else if (animation.equals(anim4)) { 
tv_anim_title.setText(" 正 在 播放 马赛 克 动画 "); 


@TargetApi(Build.VERSION_CODES.JELLY_BEAN_MR2) 
@Override 
public void onAnimationEnd(Animator animation) { 


if (animation.equals(anim1)) í 
rl yingji.add View(view2, 0); 


Bitmap bitmap = BitmapFactory.decodeResource(getResources(), mImageArray[0]); 


int width = view l.getWidth(); 


int height — bitmap.getHeight()*width/bitmap.getWidth(); 
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anim2 = ObjectAnimator.ofObject(view1, "clipBounds", 
new RectEvaluator(), new Rect(0,0,width,height), 
new Rect(width/2;height/2,width/2;height/2)); 
anim2.setDuration(mDuration ; 
anim2.addListener(this ); 
anim2.start(); 
} else if (animation.equals(anim2)) { 
rl yingji.removeView(viewl); 
rl yingji.addView(view3, 0); 
anim3 = ObjectAnimator.ofInt(view2, "ratio", 0, 100); 
anim3.setDuration(mDuration); 
anim3.addListener(this ); 
anim3.start(); 
} else if (animation.equals(anim3)) í 
rl yingji.removeView(view2); 
rl yingji.add View(view4, 0); 
int offset = 5; 
view3.setOffset(offset); 
anim4 = ObjectAnimator.ofInt(view3, "ratio", 0-offset, 101--offset); 
anim4.setDuration(mDuration); 
anim4.addListener(this); 
animd4.start(); 
} else if (animation.equals(anim4)) í 
rl yingji.removeView(view3); 
Drawable[] drawableArray = í getResources().getDrawable(mImageArray[3]). 
getResources().getDrawable(mImageArray[4]) 1; 
TransitionDrawable td fade = new TransitionDrawable(drawableAr ray); 
td fade.setCrossFadeEnabled(false); 
view4.setImageDrawable(td fade); 
int delay = mDuration; 
td fade.startTransition(delay); 
tv anim _title.setText(" 正 在 播放 淡 入 淡出 动画 7); 
mHandlerpostDelayed(mTransitionEnd, delay); 


上 


private Handler mHandler = new Handler(); 
private Runnable mTransitionEnd = new Runnable() í 
@Override 
public void run() { 
rl_yingji.addView(view5, 0); 
translateAnim = new TranslateAnimation(0f -view4.getWidth(), 0f, 0f); 
translateAnim.setDuration(mDuration); 








h 


translateAnim.setFillA fter(true); 
view4.startAnimation(translateAnim); 
translateAnim.setAnimationListener( YingjiActivity.this); 


private void startSetAnim() ( 


} 


Animation alpha = new AlphaAnimation(1.0f 0.1f); 

alpha.setDuration(mDuration); 

alpha.setFillA fter(true); 

Animation translate = new TranslateAnimation(1.0f, -200f, 1.0f, 1.0f); 

translate.setDuration(mDuration); 

translate.setFill After(true); 

Animation scale = new ScaleAnimation( 1.0f, 1.0f, 1.0f, 0.5f); 

scale.setDuration(mDuration ); 

scale.setFillA fter(true); 

Animation rotate = new RotateAnimation(0f, 360f, Animation. RELATIVE TO SELF, 
0.5f, Animation.RELATIVE TO SELF, 0.5f); 

rotate.setDuration(mDuration); 

rotate.setFillA fter(true); 

setAnim = new AnimationSet(true); 

((AnimationSet) setAnim).addAnimation(alpha); 

((AnimationSet) setAnim).addAnimation(translate); 

((AnimationSet) setAnim).addAnimation(scale); 

((AnimationSet) setAnim).addAnimation(rotate); 

setAnim.setFillA fter(true); 

viewS.startAnimation(setAnim); 

setAnim.setAnimationListener(this); 


@Override 
public void onAnimationCancel(Animator animation) { 


; 


(à Override 
public void onAnimationRepeat( Animator animation) { 


j 


@Override 
public void onAnimationStart(Animation animation) { 


if (animation.equals(translateAnim)) { 

tv_anim _title.setText(" 正 在 播放 平移 动画 "); 
} else if (animation.equals(setAnim)) { 

tv_anim title.setText(" 正 在 播放 集合 动画 "); 
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} 
@Override 
public void onAnimationEnd(Animation animation) { 
if (animation.equals(translateAnim)) { 
TL yingjiremoveView(view4); 
rl yingji.addView(view6, 0); 
startSetAnim(); 

} else if (animation.equals(setAnim)) í 
rl_yingji.removeView(view5); 
tv_anim_title.setText(" 动 感 影集 播放 结束 ， 谢 谢 观看 "); 
View6.setOnClickListener(this); 


1 
@Override 
public void onAnimationRepeat(Animation animation) { 
h 
@Override 
public void onClick(View v) { 

if (v.equals(view6)) { 

playYingji(); 
J 


126 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 常见 动画 技术 ， 包 括 帧 动画 的 用 法 〈 帧 动画 、GIF 动画 、 
淡 入 淡出 动画 ) 、 补 间 动 画 的 用 法 〈 补 间 动 画 的 种 类 与 用 法 、 集 合 动画 、 在 飞 掠 横幅 中 使 用 补 
间 动 画 ) 、 属 性 动画 的 用 法 〈 属 性 动画 、 属 性 动画 组 合 、 插 值 器 和 估 值 器 ) 、 常 见 的 动画 实现 
手段 〈 使 用 延 时 重 绘 、 设 置 状态 参数 、 滚 动 器 Scroller) 。 最 后 设计 了 一 个 实战 项 目 “ 仿 QQ 
空间 的 动感 影集 ”， 在 该 项 目的 App 编码 中 采用 本 章 介绍 的 主要 动画 技术 ， 实 现 了 图 片 动态 
轮换 的 效果 。 另 外 。 介 绍 了 画布 的 绘图 层次 ， 以 及 如 何 实现 百叶 窗 动 画 和 马赛 克 动 画 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 

CD 学 会 如 何 使 用 帧 动画 实现 动态 效果 。 

OD 学 会 在 合适 的 场合 使 用 补 间 动 画 。 

(3) 学 会 属性 动画 的 基本 用 法 和 高 级 用 法 。 

(4) 学 会 常用 的 几 种 动画 实现 手段 。 








第 1 了 = 多 W 体 


本 章 介绍 App 开发 常见 的 多 媒体 技术 ， 主 要 包括 如 何 
使 用 各 种 图 像 控 件 实现 自 定义 相册 、 如 何 使 用 视频 相关 控件 
实现 视频 播放 器 , 另外 介绍 四 大 组 件 之 一 的 ContentProvider 
的 基本 概念 与 常见 用 法 。 最 后 结合 本 章 所 学 的 知识 演示 一 个 
实战 项 目 “ 音 乐 播 放 器 一 一 浪花 音乐 ”的 设计 与 实现 。 
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13.1 dH 册 


本 节 介 绍 自 定义 相册 的 实现 过 程 ， 首 先 说 明 使 用 画廊 或 循环 视图 如 何 实现 简单 相册 ; 接 
着 阐述 使 用 图 像 切 换 器 如 何 实现 相册 的 左右 滑动 功能 ;然后 分 别 介绍 卡片 视图 与 调 色 板 的 用 
法 ， 并 结合 上 述 图 像 控件 完成 一 个 图 片 查 看 器 一 一 青青 相册 。 


13.1.1 画廊 Gallery 


前 几 章 使 用 文件 对 话 框 打开 图 片 时 只 能 看 到 图 片 的 文件 名 ， 看 不 到 图 片 的 缩 略 图 ， 对 用 
户 来 说 很 不 方便 , 因为 光 看 文件 名 怎么 知道 这 张 图 片 什么 模样 呢 ? 如 果 是 在 电脑 上 , 就 可 以 查 
看 一 组 图 片 的 缩 略图 列表 , 很 容易 找到 想 要 的 图 片 。 在 手机 上 可 以 使 用 相应 的 图 像 控 件 做 出 缩 
略图 展示 的 相册 效果 。 

画廊 Gallery 是 专门 用 于 展示 图 片 列表 的 控件 ， 左 右 滑动 手势 即 可 展示 内 嵌 的 图 片 列表 ， 
画面 效果 类 似 于 一 个 平面 万 花 简 。 尽 管 Android 将 Gallery 标记 为 Deprecation (表示 已 废弃 ) ， 
建议 开发 者 采用 HorizontalScrollView 或 ViewPager (Ú Ë, 不 过 Gallery 用 来 轮 播 图 片 是 一 个 挺 
好 的 选择 。 不 妨 了 解 一 下 Gallery 控件 ， 并 结合 其 他 控件 加 深 对 图 像 开 发 的 理解 。 

下 面 是 Gallery 的 常用 方法 说 明 。 


e setSpacing: 设置 图 片 之 间 的 间隔 大 小 ， 对 应 的 XML 属性 是 spacing. 
setUnselectedAlpha: 设置 未 选 定 图 片 的 透明 度 ， 对 应 的 XML 属性 是 unselectedAlpha. 
取 值 范围 为 0.0 ~ 1.0，0.0 表示 完全 透明 ，1.0 表示 完全 不 透明 。 

setAdapter: 设置 画廊 的 适配器 。 

getSelectedItemId: 获取 当前 选中 的 视图 序号 。 

setSelection: 设置 当前 选中 第 几 个 视图 。 

setOnltemClickListener: 设置 单项 的 点 击 监听 器 。 


使 用 画廊 看 起 来 很 简单 , 接 下 来 试 着 用 Gallery 结合 ImageView 实现 观看 画廊 的 相册 效果 。 
首先 在 布局 文件 中 放置 一 个 框架 布局 FrameLayout， 里 面 放 一 个 画廊 控件 与 一 个 图 像 视图 控 
fF, ImageView 设置 为 充满 整个 屏幕 ，Gallery 放 在 屏幕 下 方 ， 然 后 监听 Gallery 控件 的 单项 点 
击 事件 ， 当 用 户 点 击 指定 图 片 项 时 ， 使 用 ImageView 控件 填充 该 图 片 ， 也 就 是 点 小 图 看 大 图 。 

下 面 是 通过 Gallery 与 ImageView 实现 简单 相册 的 代码 : 

public class GalleryActivity extends AppCompatActivity implements OnltemClickListener í 

private ImageView iv_gallery; 

private Gallery gl_gallery; 

private int[] mImageRes = ( R.drawable.scenel, R.drawable.scene2, R.drawable.scene3, 
R.drawable.scene4, R.drawable.scene5, R.drawable.scene6 1; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


- 494 。 
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Super.onCreate(savedInstanceState); 
setContentView(R.layout.activity gallery); 
iv gallery = (ImageView) findViewById(R.id.iv gallery); 
iv gallery.setimageResource(mImageRes[0]); 
intdip pad = Utils.dip2px(this, 20); 
gl gallery = (Gallery) find ViewById(R.id.gl gallery); 
gl gallery.setPadding(0, dip pad, 0, dip pad); 
2l gallerysetSpacing(dip pad); 
gl gallery.setUnselectedApha(0.51); 
gl gallery.setAdapter(new Gallery Adapter(this, mImageRes)); 
gl gallery.setOnItemClickListener(this); 
} 


@Override 
public void onltemClick(AdapterView<?> parent, View view, int position, long id) í 
iv_gallery.setImageResource(mImageRes[position]); 
h 
J. 


Gallery 相册 的 画面 效果 如 图 13-1 和 图 13-2 所 示 。 其 中 ， 图 13-1 所 示 为 展示 相册 第 一 张 
图 片 时 的 画面 ， 图 13-2 所 示 为 点 击 第 二 张 小 图 时 ， 屏 幕 展示 第 二 张大 图 的 画面 。 





图 13-1 画廊 展示 第 一 张 图 片 图 13-2 画廊 展示 第 二 张 图 片 


如 果 想 用 其 他 控件 替代 Gallery， 就 可 以 考虑 使 用 功能 强大 的 循环 视图 RecyclerViews H 
体 实现 时 主要 是 定义 一 个 水 平方 向 的 线性 布局 管理 器 ， 然 后 通过 适配器 填 入 图 片 列表 。 
使 用 RecyclerView 与 ImageView 实现 相册 的 代码 很 简单 ， 举 例如 下 : 
public class RecyclerViewActivity extends AppCompatActivity implements OnItemClickListener í 
private ImageView iv_photo; 
private RecyclerView rv_photo; 
private int[] mImageRes = ( R.drawable.scenel, R.drawable.scene2, R.drawable.scene3, 
R.drawable.scene4, R.drawable.sceneS5, R.drawable.scene6 1; 
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@Override 

protected void onCreate(Bundle savedInstanceState) { 
Super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_recycler view); 
iv photo = (ImageView) find ViewById(R.id.iv photo); 
iv photo.setImageResource(mImageRes[0]); 
rv. photo = (RecyclerView) findViewByld(R.id.rv photo); 
LinearLayoutManager manager = new LinearLayoutManager(this); 
manager.setOrientation(LinearLayout. HORIZONTAL); 
rv. photo.setLayoutManager(manager); 
PhotoAdapter adapter = new PhotoAdapter(this, mImageRes); 
adapter.setOnItemClickListener(this); 
rv. photo.setAdapter(adapter); 
rv. photo.setItemAnimator(new DefaultItem Animator()); 
rv. photo.addItemDecoration(new SpaceslItemDecoration(20)); 


} 


@Override 

public void onltemClick( View view, int position) í 
iv_photo.setImageResource(mImageRes[position]); 
rv_photo.scrollToPosition(position); 


] 


使 用 RecyclerView 方式 实现 的 相册 效果 如 图 13-3 和 图 13-4 所 示 。 其 中 ， 图 13-3 所 示 为 展 
示 相 册 第 3 张 图 片 时 的 画面 ， 图 13-4 所 示 为 点 击 第 4 张 小 图 时 ， 屏 幕 展 示 第 4 张大 图 的 画面 。 





133 ”循环 视图 展示 第 3 张 图 片 图 13-4 ”循环 视图 展示 第 4 张 图 片 
13.1.2 图像 切换 器 ImageSwitcher 


可 能 读者 已 经 发 现 ， 前 面 Gallery 相册 在 切换 大 图 时 比较 生硬 ， 前 后 两 张 图 片 内 一 下 就 切 
过 去 了 , 用户 体验 不 够 友好 。 有 没有 办 法 让 图 片 切换 自然 一 些 呢 ， 比 如 通过 渐变 动画 的 方式 ? 
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答案 肯定 是 有 的 , 就 是 把 占据 整个 屏幕 的 图 像 视图 ImageView 换 成 图 像 切 换 器 ImageSwitcher, 
然后 通过 ImageSwitcher 实现 前 后 图 片 的 切换 动画 。 

ImageSwitcher 继承 自视 图 动画 器 ViewAnimator， 用 于 承载 前 后 两 个 图 像 的 变换 动画 ;与 
之 对 应 的 是 ， 文 本 切换 器 TextSwitcher 承载 前 后 两 个 文本 的 变换 动画 ; 第 11 章 介绍 的 飞 掠 视 
图 ViewFlipper 是 从 ViewAnimator 派生 而 来 ， 读 者 已 经 知道 它 用 来 承载 前 后 两 个 视图 的 变换 


动画 。 


下 面 介绍 ImageSwitcher 的 常用 方法 。 


setFactory: 设置 一 个 视图 工厂 。 该 视图 工厂 由 ViewFactory 派生 而 来 ， 需 重 写 makeView 
方法 返回 工厂 的 具体 视图 。 对 于 ImageSwitcher 来 说 ， 工 厂 返回 的 是 ImageView 对 象 。 
setImageResource: 设置 当前 图 像 的 资源 ID。 该 方法 与 下 面 的 setlmageDrawable 方法 和 
setImageURI 方 法 为 三 选 一 操作 ， 调 用 了 其 中 一 个 方法 ， 就 无 须 调用 另外 两 个 方法 。 
setImageDrawable: 设置 当前 图 像 的 Drawable 对 象 。 

setImageURI: 设置 当前 图 像 的 URI 地 址 。 

setInAnimation: 设置 后 一 个 图 像 的 进入 动画 。 

setOutAnimation: 设置 前 一 个 图 像 的 退出 动画 。 


这 里 运用 的 动画 技术 跟 第 11 章 和 第 12 章 的 飞 掠 视图 类 似 。 首 先 ， 对 前 后 图 片 的 切换 动 
画 可 以 事先 设置 好 集合 动画 ， 通 过 setInAnimation 和 setOutAnimation 方法 完成 动画 调用 ;其 
次 ， 前 后 图 片 的 切换 操作 不 但 可 由 Gallery 控件 的 点 击 操作 出 发 ， 而 且 可 由 手势 的 左 滑 和 右 滑 
操作 触发 ， 这 要 借助 于 手势 检测 器 GestureDetector， 通 过 检测 左 滑 手势 和 右 滑 手 势 自 动 轮 播 


图 片 。 


按照 以 上 的 设计 思路 使 用 ImageSwitcher 实现 相册 切换 动画 的 代码 如 下 : 


public void onltemClick(AdapterView<?> parent, View view, int position, long id) { 
is switcher.setInAnimation( AnimationUtils.loadAnimation(this, R.anim.fade in)); 
is switcher.setOutAnimation(AnimationUtils.loadAnimation(this, R.anim.fade out)); 
is switcher.setlmageResource(mImageRes|[position]); 


) 
public class ViewFactorylmpl implements ViewFactory í 
@Override 
public View makeView() { 
ImageView iv = new ImageView(ImageSwitcherActivity.this); 
iv.setBackgroundColor(0xFFFFFFFF); 
iv.setScaleType(ScaleType.FIT XY); 
iv.setLayoutParams(new ImageSwitcher.LayoutParams( 
LayoutParams. MATCH PARENT, LayoutParams.MATCH PARENT)); 
return iv; 
h 
; 
@Override 
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public boolean onTouch(View v, MotionEvent event) { 

mGesture.onTouchEvent(event); 

return true; 
h 
@Override 
public void gotoNext() { 

is_switcher.setInAnimation(AnimationUtils.loadAnimation(this, R.anim.push_left_in)); 

is_switcher.setOutAnimation(AnimationUtils.loadAnimation(this, R.anim.push left out)); 

int next pos = (int) (gl switcher.getSelectedItemId() + 1); 

if (next pos >= mlmageRes.length) í 

next pos = 0; 

b 

is switcher.setlImageResource(mImageRes[next. pos]); 

gl switcher.setSelection(next pos); 
) 
@Override 
public void gotoPre() { 

is_switcher.setInAnimation(AnimationUtils.loadAnimation(this, R.anim.push right in)); 

is switcher.setOutAnimation(AnimationUtils.loadAnimation(this, R.anim.push right out)); 

int pre pos = (int) (gl switcher.getSelectedItemId() - 1); 

if (pre pos < 0) í 

pre pos = mImageRes.length - 1; 

5 

is switcher.setimageResource(mImageRes[pre pos]); 

gl switcher.setSelection(pre pos); 
) 

相册 切换 动画 的 效果 如 图 13-5 和 图 13-6 所 示 。 其 中 ， 图 13-5 所 示 为 切换 开始 的 画面 ， 
此 时 右边 图 片 缓 缓 移入 屏幕 ， 图 13-6 所 示 为 切换 即将 结束 的 画面 ， 此 时 右边 图 片 已 经 大 部 分 
移入 屏幕 ， 左 边 图 片 快要 移出 屏幕 了 。 





13-5 图像 切换 刚刚 开始 的 画面 13-6 图像 切 换 即将 结束 的 画面 
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13.1.3 图片 查看 器 一 一 青青 相册 


经 过 Gallery 和 ImageSwitcher 的 配合 ， 这 个 相册 有 点 像 模 像样 了 。 当 然 ， 作 为 孜孜 不 倦 、 
勤奋 好 学 的 开发 者 ， 绝 不 能 满足 于 一 点 驹 虫 小 技 。 接 下 来 我 们 再 加 上 一 些 技术 ， 让 相册 变 得 更 
加 赏心悦目 。 

首先 加 入 的 技术 是 卡片 视图 CardView, 该 视图 是 Android 在 5.0 后 引入 的 新 控件 。 顾 名 思 
义 ，CardView 拥有 一 个 卡片 式 的 圆 角 边框 ， 边 框 外 缘 有 一 圈 阴 影 ， 边 框 内 缘 有 一 圈 空 白 。 准 
确 地 说 ，CardView 实际 上 是 一 个 布局 视图 ， 继 承 自 Framelayout， 可 以 当 作 具 有 边框 效果 的 特 
殊 布局 。 

因为 CardView 是 5.0 之 后 的 新 增 控件 ， 所 以 为 了 兼容 以 前 的 Android 版 本 ， 在 使 用 该 控 
件 前 要 先 修改 build.gradle， 即 在 dependencies 节点 中 加 入 下 面 一 行 代码 表示 导入 cardview 库 : 

compile 'com.android.support:cardview-v7:25.0.0' 

CardView 的 常用 属性 与 方法 的 说 明 见 表 13-1。 

表 13-1 CardView 的 常用 属性 与 方法 说 明 

















CardView 的 属性 名 称 CardView 的 设置 方法 说 明 

cardBackgroundColor setCardBackgroundColor 设置 卡片 边框 的 背景 颜色 
cardCornerRadius setRadius 设置 卡片 边框 的 圆 角 半径 
cardElevation setCardElevation 设置 卡片 边缘 的 阴影 高 程 ， 即 宽度 
contentPadding setContentPadding 设置 卡片 边框 的 间隔 





使 用 CardView 属性 时 需要 注意 以 下 两 点 : 

(1) 因为 cardview 库 是 作为 外 部 库 导入 的 ， 所 以 节点 属性 要 像 对 待 自 定义 控件 一 样 ， 即 
先 在 根 节点 定义 一 个 命名 空间 app 指向 res-auto， 然 后 使 用 “app: 属 性 名 称 ” 的 形式 定义 属性 
值 ， 不 可 直接 使 用 “android: 属 性 名 称 ”。 

(2) 在 设置 阴影 宽度 的 同时 设置 对 应 宽度 的 margin， 因 为 阴影 宽度 不 计 入 卡片 的 宽 高 ， 
如 果 卡 片 宽 高 设置 为 wrap_content， 阴 影 部 分 就 会 被 自动 截 掉 。 


下 面 是 使 用 CardView 的 代码 : 


public class Card ViewActivity extends AppCompatActivity { 
private CardView cv. card; 


(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity card view); 
cv card = (CardView) findViewByld(R.id.cv card); 
initCardSpinner(); 

} 

private void initCardSpinner() { 
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ArrayAdapter<String> cardAdapter = new ArrayAdapter<String>(this, 
R.layoutitem select, cardArray); 

Spinner sp card = (Spinner) findViewById(R.id.sp card); 

sp_card.setPrompt(" 请 选择 卡片 视图 类 型 "); 

sp_card.setAdapter(cardAdapter); 

sp_card.setOnltemSelectedListener(new CardSelectedListener()); 

sp card.setSelection(0); 

} 


private String[] cardArray={" 圆 角 与 阴影 均 为 3"," 圆 角 与 阴影 均 为 6", " 圆 角 与 阴影 均 为 10", 
" 圆 角 与 阴影 均 为 15", " 圆 角 与 阴影 均 为 20", " 圆 角 与 阴影 均 为 30", " 圆 角 与 阴影 均 为 50"}; 
private int[] radiusArray = (3, 6, 10, 15, 20, 30, 50}; 
class CardSelectedListener implements OnItemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View argl, int arg2, long arg3) { 
int interval = radiusArray[arg2]; 
cv card.setRadius(interval); 
cv card.setCardElevation(interval); 
MarginLayoutParams params = (MarginLayoutParams) cv. card.getLayoutParams(); 
params.setMargins(interval, interval, interval, interval); 
cv card.setLayoutParams(params); 








J 


public void onNothingSelected(AdapterView<?> arg0) í 
j 


hi 
卡片 视图 的 显示 效果 如 图 13-7 和 图 13-8 所 示 。 其 中 ， 图 13-7 所 示 为 阴影 宽度 为 6 的 画 
面 ， 此 时 卡片 看 起 来 比较 薄 ; 图 13-8 所 示 为 阴影 宽度 为 15 的 画面 ， 此 时 卡片 看 起 来 比较 厚 。 





卡片 视图 样式 : 。” 圆 角 与 阴影 均 为 6 ~ 卡片 视图 样式 : ” 圆 角 与 阴影 均 为 15 ~ 


E E 











13-7 ”阴影 厚度 为 6 的 卡片 视图 图 13-8 ”阴影 厚度 为 15 的 卡片 视图 


介绍 完 卡片 视图 ， 再 说 明 Android5.0 引入 的 另 一 个 新 控件 一 一 调 色 板 Palette。 调 色 板 把 多 
种 颜色 混合 在 一 起 ， 调 和 均匀 后 显示 出 新 颜色 。 在 App 使 用 场景 中 常常 会 用 到 背景 色调 ， 即 
根据 前 景 图 片 的 总 体 色彩 设置 与 之 接近 的 背景 色调 ， 这 样 显得 整个 画面 风格 比较 统一 。 例 如 ， 
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对 于 喜庆 的 节日 相片 可 设置 偏 红 色调 的 背景 ， 对 于 泛 黄 的 老 照片 可 设置 偏 黄 色调 的 背景 , 对 于 
山水 风景 的 图 片 可 设置 偏 绿 色调 的 背景 。 根 据 每 幅 图 片 的 色彩 情况 自动 计算 该 图 片 的 总 体 色 
调 ， 通 过 调 色 板 控件 Palette 就 能 完成 。 
因为 Palette 是 5.0 之 后 增加 的 新 控件 , 所 以 要 修改 build.gradle, 在 dependencies 节点 中 加 
入 下 面 一 行 代码 表示 导入 palette 库 : 
compile 'com.android.support:palette-v7:25.0.0' 
下 面 是 Palette 的 常用 方法 说 明 。 


e from: 从 位 图 对 象 中 获得 调 色 板 的 构建 对 象 。 

e Builder.generate: 给 构建 对 象 注册 调 色 板 的 调 色 监听 器 ， 因 为 Android 认为 计算 色调 是 耗 
时 操作 ， 得 另外 开 线程 处 理 ， 所 以 要 注册 监听 器 实现 回调 操作 。 调 色 监 听 器 需 实现 接口 
PaletteAsyncListener 的 onGenerated 方法 ， 该 方法 在 色调 计算 完毕 后 触发 。 

e getVibrantSwatch: 获取 偏 亮色 调 的 色 板 对 象 。 调 用 色 板 对 象 的 getRgb 方法 可 得 到 具体 
Bit. 

e getSwatches: 获取 所 有 色 板 对 象 。 因 为 getVibrantSwatch 方法 有 时 会 返回 null， 此 时 要 调 
用 getSwatches 方法 取 第 一 条 颜色 。 


调 色 板 的 具体 应 用 可 跟 卡 片 视图 联合 使 用 ， 也 就 是 把 调 色 板 计算 得 到 的 色调 填 入 卡片 视 
图 的 边框 背景 中 ， 从 而 实现 卡片 原 图 与 边框 的 色彩 呼应 效果 。 
使 用 调 色 板 的 代码 如 下 : 


private void initPalette() { 
for (int i=0; i<mImageRes.length; i++) í 
Drawable drawable = getResources().getDrawable(mImageRes[i]); 
Bitmap bitmap = ((BitmapDrawable)drawable).getBitmap(); 
Palette.Builder builder = Palette.from(bitmap); 
builder.generate(new MyPaletteListener(i)); 


j 


private class MyPaletteListener implements PaletteAsyncListener í 
private int mPos; 
public MyPaletteListener(int pos) í 
mPos = pos; 
; 
@Override 
public void onGenerated(Palette palette) { 
Palette.Swatch swatch = palette.get VibrantSwatch(); 
if (swatch != null) í 
mBackColors[mPos] = swatch.getRgb(); 
lelse( //getVibrantSwatch 有 时 会 返回 null， 此 时 从 getSwatches 取 第 一 条 颜色 
List<Palette.Swatch> swatches = palette.getSwatches(); 
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for (int i-0; i<swatches.size(); i++) í 
Palette.Swatch item = swatches.get(i); 
mBackColors[mPos] = item.getRgb(); 
break; 

; 


h 
gl album.setAdapter(new AlbumAdapter( AlbumActivity.this, mImageRes, mBackColors)); 


1 
学 会 了 卡片 视图 与 调 色 板 的 用 法 ， 剩 下 的 工作 便 是 精确 加 工 相册 的 每 张 缩 略 图 ， 给 它们 
加 上 卡片 边框 ， 并 给 边框 背景 设置 该 缩 略 图 的 调和 色 。 赶 紧 动 手 进行 实践 ， 体 验 一 下 自己 的 劳 
动 成 果 带 来 的 喜悦 吧 ! 
装饰 后 的 相册 效果 如 图 13-9 和 图 13-10 所 示 。 其 中 ， 图 13-9 所 示 为 打开 第 一 张 图 片 时 的 
相册 画面 ， 图 13-10 所 示 为 打开 最 后 一 张 图 片 的 相册 画面 。 





图 13-9 青青 相册 查看 第 一 张 图 片 图 13-10 青青 相册 查看 最 后 一 张 图 片 


至 此 ， 一 个 初 具 面貌 的 相册 基本 完工 了 。 叫 好 的 App 还 得 有 个 好 听 的 名 称 ， 笔 者 姑且 将 
它 命 名 为 “青青 相册 ”， 读 者 看 看 要 不 要 加 上 什么 新 功能 ， 再 取 一 个 更 好 听 的 名 字 ? 


13.2 ”视频 播放 


本 节 介 绍 视频 播放 的 相关 技术 ， 首 先 说 明 视频 视图 的 工作 原理 ， 结 合 拖 动 条 实现 简单 的 
视频 播放 器 ; 接着 阐述 媒体 控制 条 的 用 法 ,以 及 媒体 控制 条 与 视频 视图 的 两 种 绑 定 方式 ; 最 后 
演示 阶段 性 实战 项 目 “ 影 视 播 放 器 一 一 爱 看 剧场 ”的 改造 方案 和 具体 的 实施 细节 。 
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13.2.1 


视频 视图 VideoView 


第 9 章 在 介绍 录像 放映 功能 时 使 用 了 MediaPlayer 结合 SurfaceView 播放 视频 文件 ， 其 中 
通过 SurfaceView 显示 视频 的 画面 ， 通 过 MediaPlayer 设置 播放 参数 并 控制 视频 的 播放 操作 。 
不 过 仅仅 播 一 个 视频 就 得 如 此 深入 掌握 技术 细节 未 免 太 兴 师 动 众 了 , 因此 Android 推出 了 视频 
视图 VideoView, 该 控件 内 部 集成 了 SurfaceView 和 MediaPlayer， 从 而 实现 视频 画面 与 视频 操 
作 的 统一 管理 ， 为 开发 者 进行 视频 开发 提供 便利 。 

下 面 是 VideoView 的 常用 方法 说 明 。 





setVideoPath: 设置 视频 文件 的 路 径 。 

setMediaController: 设置 媒体 控制 条 的 对 象 。 

setOnPreparedListener: 设置 预备 播放 监听 器 。 需 实现 监听 器 OnPreparedListener 的 
onPrepared 方法 ， 该 方法 在 准备 播放 时 调用 。 

setOnCompletionListener: 设置 结束 播放 监听 器 。 需 实现 监听 器 OnCompletionListener 的 
onCompletion 方法 ， 该 方法 在 结束 播放 时 调用 。 

setOnErrorListener: 设置 播放 异常 监听 器 。 需 实现 监听 器 OnErrorListener 的 onError 方法 ， 
该 方法 在 播放 出 现 异 常 时 调用 。 

setOnInfoListener: 设置 播放 信息 监听 器 。 需 实现 监听 器 OnInfoListener 的 onInfo 方法 ， 
该 方法 在 播放 需要 传递 某 种 消息 时 调用 ， 如 开始 /结束 缓冲 。 

requestFocus: 请 求 获得 焦点 。 该 方法 要 在 start 方法 前 调用 。 

start: 开始 播放 视频 。 

pause: 暂停 播放 视频 。 

resume: 恢复 播放 视频 。 

suspend: 结束 播放 并 释放 资源 。 

seekTo: 拖 动 视频 到 指定 进度 开始 播放 。 

getDuration: 获得 视频 的 总 时 长 。 

getCurrentPosition: 获得 当前 的 播放 位 置 。 该 方法 返回 值 与 getDuration 相等 时 ， 表 示 播 
放 到 了 末尾 。 

isPlaying: 判断 是 否 正在 播放 。 

getBufferPercentage: 获得 已 缓冲 的 比例 。 返 回 值 在 0 到 1 之 间 。 


由 于 VideoView 只 是 一 个 播放 界面 ， 本 身 不 会 显示 进度 条 ， 因 此 实际 开发 中 至 少 得 给 它 
配备 一 个 拖 动 条 SeekBar， 一 方面 用 来 展示 当前 的 播放 进度 ， 另 一 方面 用 来 拖 动 播放 位 置 。 

在 VideoView 的 方法 中 ，SeekBar 主要 用 到 了 三 个 方法 ， 第 一 个 getDuration 方法 获得 的 
总 时 长 对 应 拖 动 条 的 最 大 进度 值 ， 第 二 个 getCurrentPosition 方法 对 应 拖 动 条 的 当前 进度 值 ， 
第 三 个 seekTo 方法 是 在 用 户 拖 动 SeekBar 结束 后 调用 。 为 VideoView 加 上 SeekBar， 即 可 实 
现 基本 的 播放 控制 操作 。 

下 面 是 使 用 VideoView 结合 SeekBar 的 代码 ， 相 比 第 9 章 的 放映 代码 明显 精简 许多 : 
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public class VideoViewActivity extends AppCompatActivity implements 
OnClickListener, FileSelectCallbacks, OnSeekBarChangeL istener í 
private VideoView vv play; 
private SeekBar sb play; 


@Override 

protected void onCreate(Bundle savedInstanceState) ( 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity video view); 
findViewById(R.id.btn open).setOnClickListener(this); 
vv. play = (VideoView) find ViewById(R.id.vv play); 
sb play = (SeekBar) findViewById(R.id.sb play); 
sb play.setOnSeekBarChangeL istener(this); 
sb play.setEnabled(false); 

j 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.btn open) í 
FileSelectFragment.show(this, new String[] í "mp4" }, null); 


; 


(@Override 

public void onConfirmSelect(String absolutePath, String fileName, Map<String, Object> map param) í 
String file path = absolutePath + "/" + fileName; 
vv. play.setVideoPath(file path); 


vv. play.requestFocus(); 
vv. play.start(); 
sb play.setEnabled(true); 
mHandler.post(mRefresh); 
j 
@Override 
public boolean isFileValid(String absolutePath, String fileName, Map<String, Object> map_param) { 
return true; 
j 


private Handler mHandler = new Handler); 
private Runnable mRefresh = new Runnable() í 
@Override 
public void run() { 
sb play.setProgress(100 * vv_play.getCurrentPosition()/vv_play.getDuration()); 
mHandler.postDelayed(this, 500); 
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@Override 

public void onProgressChanged(SeekBar seekBar, int progress,boolean fromUser) { 

} 

@Override 

public void onStartTrackingTouch(SeekBar seekBar) { 

1 

@Override 

public void onStopTrackingTouch(SeekBar seekBar) { 
int pos = seekBar.getProgress() * vv_play.getDuration() / 100; 
vv_play.seekTo(pos); 


) 

VideoView 与 SeekBar 的 播放 效果 如 图 13-11 和 图 13-12 所 示 。 其 中 ， 图 13-11 所 示 为 视 
频 播 放 开始 的 画面 ， 此 时 拖 动 条 的 进度 图 标 尚 在 左边 ; 图 13-12 所 示 为 视频 播放 即将 结束 的 画 
面 ， 此 时 拖 动 条 的 进度 图 标 已 经 移 到 右边 了 。 


media 


打开 视频 文件 
yc 


media 








图 13-11 视频 视图 刚刚 开始 播放 图 13-12 视频 视图 即将 结束 播放 
13.22 ”媒体 控制 条 MediaController 


使 用 拖 动 条 主要 完成 两 个 播放 控制 功能 : 显示 当前 播放 进度 和 拖 动 到 指定 位 置 播放 。 这 
两 个 基本 功能 显然 不 够 全 面 ， 对 于 一 个 视频 播放 器 来 说 ， 至 少 还 得 实现 下 列 基 础 功能 : 

(1) 暂停 功能 和 暂停 之 后 的 恢复 播放 功能 。 

(2) 查看 视频 的 总 时 长 和 当前 已 播放 的 时 长 。 

(3) 快 进 和 快 退 功能 。 

前 面 介绍 VideoView 的 常用 方法 时 提 到 setMediaController 方 法 可 设置 媒体 控制 条 的 对 象 ， 
这 个 媒体 控制 条 就 是 MediaController， 它 的 界面 跟 Windows 上 的 播放 条 几乎 一 模 一 样 ， 并 支 
持 一 些 基本 的 播放 控制 操作 : 显示 当前 的 播放 进度 、 拖 动 到 指定 位 置 播放 、 和 暂停 播 放 与 恢复 播 
放 、 查 看 视频 的 总 时 长 和 已 播放 时 长 、 对 视频 做 快 进 或 快 退 操作 等 。 
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下 面 是 MediaController 的 常用 方法 说 明 。 


e setMediaPlayer: 设置 媒体 播放 器 的 对 象 ， 即 VideoView 对 象 。 该 方法 与 setAnchorView 
只 能 调用 一 个 。 

e setAnchorView: 设置 绑 定 的 主 视图 ， 其 实 一 般 是 一 个 VideoView 对 象 。 该 方法 与 

setMediaPlayer 只 能 调用 一 个 。 

show: 显示 媒体 控制 条 。 

hide: 隐藏 媒体 控制 条 。 

isShowing: 判断 媒体 控制 条 是 否 正在 显示 。 

setPrevNextListeners: 设置 前 一 个 按钮 与 后 一 个 按钮 的 点 击 监听 器 (OnClickListener ) 。 

如 果 没 调用 该 方法 ， 那 么 前 一 个 按钮 与 后 一 个 按钮 都 不 会 展示 。 

VideoView 继承 自 SurfaceView， 而 MediaController 继承 自 FrameLayout， 理 论 上 这 两 个 
控件 是 可 以 随意 摆 放 的 ， 但 是 考虑 到 用 户 的 使 用 习惯 ,往往 将 其 集成 在 一 起 展示 ， 即 媒体 控制 
条 固定 放 在 视频 视图 的 底部 。 因 此 无 须 在 布局 文件 中 声明 MediaController 控件 ， 只 需 声 明 
VideoView 控件 , 然后 在 代码 中 将 媒体 控制 条 附着 于 视频 视图 即 可 。 甚 至 布局 文件 中 都 不 用 声 
明 VideoView， 在 代码 中 动态 添加 视频 视图 和 媒体 控制 条 即 可 。 由 此 衍生 出 VideoView 与 
MediaController 的 两 种 集成 方式 : 在 布局 文件 中 声明 VideoView 和 在 代码 中 动态 添加 
VideoView 。 


1. 在 布局 文件 中 声明 VideoView 


视频 视图 对 象 的 使 用 步骤 不 变 ， 即 先 调用 setVideoPath 方法 指定 视频 文件 ， 然 后 调用 
setMediaController 方法 指定 控制 条 ， 最 后 调用 start 方法 开始 播放 。 此 时 媒体 控制 条 对 象 在 完 
成 构建 后 只 需 调 用 setMediaPlayer 方法 设置 播放 器 对 象 即 可 。 
该 方式 的 控件 集成 代码 如 下 : 
public void onConfirmSelect(String absolutePath, String fileName, Map<String, Object> map_param) í 
String file path = absolutePath + "/" + fileName; 
vv. play.setVideoPath(file path); 
vv. play.requestFocus(); 
/媒体 控制 条 代码 开始 
MediaController mc play = new MediaController(this); 
vv. play.setMediaController(mc play); 
mc play.setMediaPlayer(vv play); 
/媒体 控制 条 代码 结束 
vv_play.start(); 


} 
2. 在 代码 中 动态 添加 VideoView 


视频 视图 对 象 需要 在 代码 中 构建 并 添加 ， 其 余 使 用 步骤 同上 。 此 时 媒体 控制 条 对 象 的 使 
旧 步 又 发 生变 化 ， 不 再 调用 setMediaPlayer 方法 ， 而 改 成 调用 setAnchorView 方法 ， 该 方法 把 
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媒体 控制 条 添加 到 宿主 视图 上 ， 如 果 方 法 参数 是 一 个 VideoView 对 象 ， 就 将 媒体 控制 条 添加 
到 VideoView 的 上 级 视图 。 
该 方式 的 控件 集成 代码 如 下 : 


public void onConfirmSelect(String absolutePath, String fileName, Map<String, Object» map param) { 
String file path = absolutePath + "/" + fileName; 
VideoView vv play = new VideoView(this); 
vv. play.setVideoPath(file path); 
vv. play.requestFocus(); 
MediaController mc play = new MediaController(this); 
mc play.setAnchorView(vv play); 
mc play.setKeepScreenOn(true); 
vv. play.setMediaController(mc play); 
ll play.addView(vv play); 
vv. play.start(); 





j 
两 种 集成 方式 的 屏幕 画面 基本 一 致 ， 开 发 者 可 根据 视频 的 展示 位 置 决定 采用 哪 一 种 方式 。 
视频 播放 开始 时 不 会 显示 媒体 控制 条 , 只 有 用 户 点 击 视频 画面 后 才 会 弹出 控制 条 ; 如 果 过 了 几 
秒 没 有 操作 控制 条 ， 它 就 会 自动 消失 。 
集成 后 的 播放 效果 如 图 13-13 和 图 13-14 所 示 。 其 中 ， 图 13-13 所 示 为 视频 播放 一 开始 的 
画面 ， 不 点 击 视频 画面 就 不 会 出 现 媒体 控制 条 ; 图 13-14 所 示 为 点 击 视频 画面 后 的 截图 ， 点 击 
后 弹出 媒体 控制 条 ， 即 可 进行 视频 播放 的 控制 操作 。 


media 


打开 视频 文件 


p” 


media 


打开 视频 文件 


N 











图 13-13 ”媒体 控制 条 已 隐藏 13-14 ”媒体 控制 条 已 弹出 来 
13.2.3 ”影视 播放 器 一 一 爱 看 剧场 
从 前 面 VideoView 和 MediaController 的 集成 效果 来 看 ， 这 个 视频 播放 器 只 提供 基本 的 播 
放 控制 ， 欠 缺 许多 高 级 播放 功效 ， 包 括 : 


CD 控制 条 分 上 下 两 行 ， 上 面 是 控制 按钮 ， 下 面 是 进度 条 ， 高 度 太 宽 ， 有 但 观瞻 。 
(2) 按钮 样式 无 法 定制 ， 不 能 增加 新 按钮 ， 也 无 法 删除 按钮 。 
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(3) 进度 条 与 播放 时 间 的 样式 也 不 能 定制 。 

(4) 播放 器 的 视频 画面 不 会 自动 全 屏 显 示 。 

(5) 播放 器 无 法 控制 调 大 和 调 小 音量 。 

(6) 播放 器 不 会 自动 设置 标题 和 背景 。 

基于 以 上 缺陷 ， 要 想 让 视频 播放 画面 生动 活泼 起 来 ， 势 必要 重新 写 一 个 既 好 看 又 好 用 的 
播放 器 。 这 里 既 要 对 视频 视图 VideoView 进行 重 写 ， 又 要 对 媒体 控制 条 MediaController 进行 
重 写 。 经 过 进一步 查看 源码 与 深入 分 析 ， 我 们 发 现 播放 器 的 改造 内 容 主要 分 为 两 个 方面 ， 一 方 
面 是 对 视频 画面 做 功能 方面 的 增强 另 一 方面 是 对 控制 条 做 样式 方面 的 定制 。 视 频 视图 和 媒体 
播放 条 的 改造 方案 基本 确定 如 下 : 


1. 增强 VideoView 的 功能 

可 以 派生 一 个 电影 视图 MovieView， 并 提供 以 下 新 增 功能 : 

CD 重 写 尺 寸 测量 方法 onMeasure， 实 现 自动 全 屏 。 

(2) 重 写 触摸 事件 监听 方法 onTouch， 用 于 弹出 或 关闭 视频 控制 条 。 
G) 重 写 按键 事件 监听 方法 onKeyDown， 用 于 调节 音量 的 大 小 。 
(4) 补充 新 方法 用 于 设置 标题 和 背景 。 

2. 定制 MediaController 的 样式 


由 于 媒体 控制 条 的 内 部 控件 都 是 私有 的 ， 即 使 继承 了 也 无 法 修改 ， 因 此 只 能 自己 写 一 个 
全 新 的 视频 控制 条 VideoController。 好 在 需求 只 是 更 改 控制 条 的 样式 ， 并 未 增加 复杂 功能 ， 所 
以 视频 控制 条 提供 以 下 控件 即 可 : 


(1) 一 个 播放 按钮 ， 点 击 按钮 暂停 播放 ， 再 次 点 击 恢复 播放 。 
QD 一 个 拖 动 条 ， 动 态 显示 当前 播放 进度 ， 允 许 把 视频 拖 动 到 指定 位 置 开始 播放 。 
(3) 两 个 文本 控件 ， 一 个 显示 视频 的 总 时 长 ， 另 一 个 显示 视频 的 已 播放 时 长 。 


视频 控制 条 的 难点 在 于 如 何 跟 电影 视图 同步 当前 的 播放 进度 。 对 于 电影 视图 向 控制 条 通 
知 播放 进度 ,可 以 设置 定时 器 持续 刷新 播放 进度 ; 对 于 控制 条 向 电影 视图 通知 播放 动作 ， 可 以 
监听 播放 按钮 的 点 击 事件 和 拖 动 条 的 拖 动 事件 ， 并 将 事件 处 理 结果 传 给 电影 视图 MovieView 
对 象 。 

如 果 只 修改 代码 ， 还 不 能 完全 实现 自动 全 屏 功 能 ， 主 要 问题 如 下 : 


(1) 手机 屏幕 项 部 的 系统 状态 栏 依然 停留 在 屏幕 项 端 。 

(2) App 自身 的 导航 栏 没 有 隐藏 。 

G) 在 视频 播放 途中 ， 如 果 手 机 屏幕 发 生 切 换 操 作 〈 如 从 竖 屏 变 为 横 屏 ) ， 视 频 播放 就 
会 停止 ， 回 到 播放 页 面 刚 进去 的 初始 画面 。 

对 于 前 两 个 问题 ， 可 增加 一 个 全 屏 的 页 面 风格 ， 并 给 视频 播放 页 面 的 activity 节点 设置 
android:theme 属性 予以 调整 。 全 屏风 格 的 内 容 包括 设置 属性 android:windowFullscreen 隐藏 系 
统 状 态 栏 、 设 置 属性 android:windowNoTitle 去 除 App 的 导航 栏 、 设 置 属 性 android: 
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windowContentOverlay 清除 窗 体 背 景 。 全 屏风 格 的 具体 设置 如 下 : 


«style name-"FullScreenTheme" parent="AppBaseTheme"> 

«item name-"android:windowFullscreen"»true-/item 

«item name-"android:windowNoTitle"^true-/item 

<item name-"android:windowContentO verlay"- (gjnullc/item- 
</style> 


对 于 第 3 个 问题 ， 可 给 activity 节点 增加 属性 android:configChanges， 并 设置 合适 的 属性 
值 加 以 预防 。 因 为 默认 情况 下 ，App 每 次 切换 屏幕 都 会 重启 Activity， 即 先 执行 活动 页 面 的 
onDestroy 方法 ， 再 执行 活动 页 面 的 onCreate 方法 (具体 参见 第 3 章 的 Activity 生命 周期 ) ， 
这 便 导 致 正在 播放 的 视频 被 中 断 返回 了 。 新 增 属性 configChanges 的 意思 是 ， 在 某 些 情况 下 ， 
屏幕 变更 不 用 重启 活动 页 面 ， 只 需 调 用 onConfigurationChanged 方法 重新 设 定 显示 方式 。 所 以 
只 要 给 该 属性 指定 若干 肯 免 情况 ,就 能 避免 无 谓 的 页 面 重 启 操作 。 屏幕 变 更 鹤 免 情况 的 取 值 说 
明 见 表 13-2。 











R132 ”屏幕 变更 豁免 情况 的 取 值 说 明 














configChanges 属性 的 取 值 说 明 

touchscreen 触摸 屏 发 生 改变 ， 一 般 不 会 发 生 

keyboard 键盘 发 生 改 变 ， 例 如 使 用 了 外 部 键盘 
keyboardHidden 软 键盘 弹出 或 隐藏 

navigation 导航 发 生 改变 ， 一 般 不 会 发 生 

ScreenLayout 屏幕 的 显示 发 生 改变 ， 例 如 使 用 了 外 部 显示 器 
fontScale 字体 比例 发 生 改 变 ， 例 如 在 系统 设置 中 调整 默认 字体 
orientation 屏幕 发 生 横 屏 与 竖 屏 的 切换 

screenSize 屏幕 大 小 发 生 改变 


另外 ， 要 新 增 screenOrientation 属性 ， 表 明 该 页 面 允许 哪 种 形式 的 屏幕 方 向 。 对 于 视频 播 
放 页 面 来 说 ， 该 属性 值 要 设置 为 sensor， 表 示 由 传感器 控制 。 屏幕 方 向 的 取 值 说 明 见 表 13-3。 


表 13-3 ”屏幕 方向 的 取 值 说 明 




















screenOrientation 属性 的 取 值 说 明 

portrait 只 允许 垂直 方向 

landscape 只 允许 水 平方 向 

sensor 由 传感器 控制 方向 

unspecified 默认 值 ， 由 系统 选择 方向 

user 使 用 用 户 当前 首选 的 方向 

fullSensor 显示 的 4 个 方向 由 传感器 决定 ， 即 4 个 方向 都 允许 倒转 


下 面 是 视频 播放 页 面 的 activity 节点 配置 : 
<activity 
android:name=".MoviePlayerActivity" 
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android:configChanges-"orientation|keyboardHidden|screenSize" 
android:screenOrientation-"sensor" 
android:theme-" (astyle/FullScreenTheme" > 

</activity> 


改造 后 的 电影 视图 MovieView 代码 如 下 : 


// 支 持 以 下 功能 : 自动 全 屏 、 调 节 音 量 、 收 缩 控制 栏 、 设 置 背 景 
@TargetApi(Build.VERSION_CODES.JELLY_BEAN) //setBackground 需要 
public class MovieView extends VideoView implements OnTouchListener.OnKeyListener, VolumeAdjustListener í 

private static final String TAG = "MovieView"; 

private Context mContext; 

private int screen Width, screenHeight; 

private int video Width, videoHeight; 

private int realWidth, realHeight; 

private int mXpos, mYpos, mOffset; 

/ 自动 隐藏 项 部 和 底部 View 的 时 间 

public static final int HIDE_TIME = 5000; 

private View mTopView; 

private View mBottomView; 

private AudioManager mAudioMgr; 

private VolumeDialog dialog; 

private Handler mHandler = new Handler); 


public MovieView(Context context) í 
this(context, null); 


public MovieView(Context context, AttributeSet attrs) í 
this(context, attrs, 0); 


public MovieView(Context context, AttributeSet attrs, int defStyle) í 
super(context, attrs, defStyle); 
mContext = context; 
screenWidth — DisplayUtil.getSreenWidth(mContext); 
screenHeight — DisplayUtil.getSreenHeight(mContext); 
mOffset = Utils.dip2px(mContext, 10); 
mAudioMgr = (AudioManager) mContext.getSystemService(Context.AUDIO SERVICE); 


(@Override 
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) í 
int width = getDefaultSize(realWidth, widthMeasureSpec); 
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int height = getDefaultSize(realHeight, heightMeasureSpec); 
if (real Width > 0 && realHeight > 0) í 
if (real Width * height > width * realHeight) í 
height = width * realHeight / real Width; 
} else if (real Width * height < width * realHeight) í 
width = height * real Width / realHeight; 


j 
; 
setMeasuredDimension(width, height); 
j 
(G)Override 


public boolean onTouch(View v, MotionEvent event) í 

switch (event.getAction()) í 

case MotionEvent. ACTION DOWN: 
mXpos - (int) event.getX(); 
mYpos - (int) event.getY(); 
break; 

case MotionEvent. ACTION UP: 
if (Math.abs(event.getX()-mXpos) < mOffset && Math.abs(event.get Y()-mYpos) < mOffset) í 

showOrHide(); 


break; 
J 


return true; 


public void prepare( View topTiew, View bottom View) í 
mTopView = topTiew; 
mBottomView = bottomView; 
setBackgroundResource(R.drawable.video bgl); 


public void begin(MediaPlayer mp) í 
setBackground(null); 
if (mp != null) í 
videoWidth — mp.getVideoWidth(); 
videoHeight — mp.getVideoHeight(); 
; 
real Width = videoWidth; 
realHeight — videoHeight; 
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start(); 


public void end(MediaPlayer mp) í 
setBackgroundResource(R.drawable.video bg3); 
real Width = screen Width; 
realHeight — screenHeight; 


public void showOrHide() { 
if (mTopView—-null || mBottomView—-null) í 
return; 


I 
if (mTopView.getVisibility() — View.VISIBLE) { 


mTopView.clearAnimation(); 
Animation animTop = AnimationUtils.loadAnimation(mContext, R.anim.leave from top); 
animTop.setAnimationListener(new AnimationImp() í 
(@Override 
public void onAnimationEnd(Animation animation) { 
mTopView.setVisibility( View. GONE); 


D: 
mTopView.startAnimation(animTop); 
mBottomView.clearAnimation(); 
Animation animBottom — AnimationUtils.loadAnimation(mContext, R.anim.leave from bottom); 
animBottom.setAnimationListener(new AnimationImp() í 
@Override 
public void onAnimationEnd(Animation animation) { 
mBottomView.setVisibility(View. GONE); 


D; 
mBottomView.startAnimation(animBottom); 


) else ( 


mTopView.setVisibility(View.VISIBLE); 

mTopView.clearAnimation(); 

Animation animTop = AnimationUtils.loadAnimation(mContext, R.anim.entry from top); 
mTopView.startAnimation(animTop); 

mBottomView.setVisibility( View. VISIBLE); 

mBottomView.clearAnimation(); 

Animation animBottom = AnimationUtils.loadAnimation(mContext, R.anim.entry from bottom); 
mBottomView.start Animation(animBottom); 

mHandler.removeCallbacks(mHide); 

mHandler.postDelayed(mHide, HIDE TIME); 
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private Runnable mHide = new Runnable() í 
@Override 
public void run() { 
showOrHide(); 


h 


private class AnimationImp implements AnimationListener í 
@Override 
public void onAnimationEnd(Animation animation) { 


j 


@Override 
public void onAnimationRepeat(Animation animation) { 


j 


@Override 
public void onAnimationStart(Animation animation) { 


j 


(@Override 
public boolean onKey(View v, int keyCode, KeyEvent event) í 
if (KeyCode = KeyEven.KEYCODE VOLUME UP) { 
showVolumeDialog(AudioManager.ADJUST RAISE); 
return true; 
} else if (keyCode = KeyEven.KEYCODE VOLUME DOWN) í 
showVolumeDialog(AudioManager.ADJUST LOWER); 
return true; 


J 


return false; 


private void showVolumeDialog(int direction) í 
if (dialog—null || dialog.isShowing()!-true) í 
dialog = new VolumeDialog(mContext); 
dialog.setVolumeA djustListener(this); 
dialog.show(); 
; 
dialog.adjustVolume(direction, true); 
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onVolumeAdjust(mAudioMgr.getStreamVolume( AudioManager.STREAM MUSIC)); 
} 


@Override 
public void onVolumeAdjust(int volume) { 
5 
; 
最 终 的 影视 播放 器 效果 如 图 13-15 一 图 13-18 所 示 。 其 中 ， 图 13-15 所 示 为 播放 器 启动 的 
初始 画面 , 一 开始 没有 打开 视频 , 先 显示 默认 背景 ; 图 13-16 所 示 为 打开 视频 开始 播放 的 画面 ， 


此 时 视频 上 部 展示 标题 栏 、 下 部 展示 控制 条 。 


视频 播放 (打开 视频 ) [LLLI 





13-15. ” 爱 看 剧场 初始 画面 图 13-16 爱 看 剧场 开始 播放 
如 果 播 放 过 程 中 不 做 任何 操作 ,标题 栏 与 控制 条 等 待 五 秒 后 就 会 自动 隐藏 ， 如 图 13-17 所 


xv. Ea. 


示 。 如 果 需 要 调节 音量 大 小 ， 就 按 手机 侧面 的 加 、 减 按钮 ， 屏 幕 中 央 会 自动 弹出 音量 对 话 框 ， 
如 图 13-18 所 示 。 音 量 对 话 框 的 实现 过 程 参见 第 11 章 。 
KT] 








图 13-17 爱 看 剧场 正在 播放 13-18 ” 爱 看 剧场 调节 音量 
经 过 一 番 改 造 ， 这 个 影视 播放 器 总 算 满足 了 大 部 分 日 常 播放 要 求 ， 这 也 是 主流 视频 播放 
器 必 备 的 播放 功能 。 怎么 样 ， 是 不 是 颇 有 成 就 感 呢 ? 该 播放 器 作为 阶段 性 的 实战 项 目 , 给 取 一 
个 大 名 ， 叫 “ 爱 看 剧场 ”好 了 。 


13.3. 内容 提供 与 处 理 


本 节 介 绍 Android 四 大 组 件 之 一 的 ContentProvider 的 基本 概念 和 常见 用 法 。 首 先 说 明 如 何 
使 用 内 容 提 供 器 封装 数据 的 外 部 访问 接口 ;接着 曾 述 如 何 通过 内 容 解析 器 在 外 部 查询 和 修改 数 
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据 ， 以 及 使 用 内 容 操作 器 完成 批量 数据 操作 ; 然后 说 明 内 容 观 察 器 的 应 用 场合 ， 并 演示 如 何 借 
助 内 容 观察 器 实现 流量 校准 的 功能 。 


13.3.1 内 容 提供 器 ContentProvider 


Android 号 称 提供 了 四 大 组 件 ， 分 别 是 页 面 Activity、 广 播 Broadcast、 服 务 Service 和 内 容 
提供 器 ContentProvider， 前 3 个 组 件 已 经 分 别 在 第 3 章 、 第 5 章 、 第 6 章 做 了 详细 介绍 ， 现 在 
总 算 轮 到 ContentProvider 了 ， 之 所 以 这 么 迟 提 到 内 容 提供 器 ， 是 因为 它 的 使 用 场合 相对 有 限 ， 
往往 容易 被 人 直接 忽略 。 

ContentProvider 为 App 存 取 内 部 数据 提供 统一 的 外 部 接口 ， 让 不 同 的 应 用 之 间 得 以 共享 
数据 。 像 我 们 熟知 的 SQLite 操作 的 是 应 用 自身 的 内 部 数据 库 ， 文 件 的 上 传 和 下 载 操作 的 是 后 
端 服务 器 的 文件 ， 而 ContentProvider 操作 的 是 本 设备 其 他 应 用 的 内 部 数据 ， 是 一 种 中 间 层 次 
的 数据 存储 形式 。 

在 实际 编码 中 ，ContentProvider 只 是 一 个 服务 端的 数据 存 取 接 口 , 开发 者 需要 在 其 基础 上 
实现 一 个 具体 类 ， 并 重 写 以 下 相关 数据 库 管理 方法 。 


onCreate: 创建 数据 库 并 获得 数据 库 连 接 。 
query: 查询 数据 。 

insert: 插入 数据 。 

update: 更 新 数据 。 

delete: 删除 数据 。 

getType: 获取 数据 类 型 。 


这 些 方法 看 起 来 是 不 是 很 像 SOLite? 没 错 ，ContentProvider 作为 中 间接 口 ， 本 身 并 不 直 
接 保 存 数据 ， 而 是 通过 SOLiteOpenHelper 与 SQLiteDatabase 间接 操作 底层 的 SQLite。 所 以 要 
想 使 用 ContentProvider， 首 先 得 实现 SQLite 的 数据 表 帮 助 类 ， 然 后 由 ContentProvider 封装 对 
外 的 接口 。 

下 面 是 使 用 ContentProvider 提供 用 户 信息 对 外 接口 的 代码 : 


public class UserInfoProvider extends ContentProvider í 
public static final int USER_INFO = 1; 
public static final UriMatcher uriMatcher = new UriMatcher(UriMatcher. NO_MATCH); 
// 这 里 的 AUTHORITIES 取 值 必须 与 AndroidManifest.xml 里 的 android:authorities 保持 一 致 
static { 
uriMatcher.addURI(UserInfoContent.AUTHORITIES, "/user", USER. INFO); 





i 
private UserDBHelper userDB; 


/删除 数据 

@Override 

public int delete(Uri uri, String selection, String[] selectionArgs) { 
int count = 0; 
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if (uriMatcher.match(uri) = USER INFO) ( 
SQLiteDatabase db — userDB.getWritableDatabase(); 
count — db.delete(UserInfoContent. TABLE NAME, selection, selectionArgs); 
db.close(); 

H 


return count; 


// 插 入 数据 
@Override 
public Uri insert(Uri uri, ContentValues values) { 
Uri newUri = uri; 
if (uriMatcher.match(uri) — USER INFO) í 
SQLiteDatabase db = userDB.getWritableDatabase(); 
/ 向 指定 的 表 插入 数据 ， 得 到 返回 的 id 
long rowld = db.insert(UserInfoContent. TABLE NAME, null, values); 
if(rowld > 0) {// 判断 插入 是 否 执行 成 功 
// 如 果 添 加 成 功 ， 就 利用 新 添加 的 id 和 新 生成 的 地 址 
newUri = ContentUris.withAppendedId( UserInfoContent. CONTENT URI, rowId); 
/ 通知 监听 器 ， 数 据 已 经 改变 
getContext().getContentResolver().notifyChange(newUri, null); 
i 
db.close(); 


J 


return uri; 


// 创 建 ContentProvider 时 调用 的 回调 函数 

(@Override 

public boolean onCreate() í 
userDB = UserDBHelper.getlnstance(getContext(). 1); 
return false; 


/查询 数据 库 
(@Override 
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { 
Cursor cursor = null; 
if (uriMatcher.match(uri) = USER_INFO) í 
SQLiteDatabase db = userDB.getReadableDatabase(); 
// 执行 查询 
cursor = db.query(UserInfoContent. TABLE NAME, 
projection, selection, selectionArgs, null, null, sortOrder); 
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// 设置 监听 
cursor.setNotificationUri(getContext().getContentResolver(), uri); 
J 


return cursor; 
} 
/数据 访问 类 型 ， 暂 未 实现 
@Override 
public String getType(Uri uri) { 
throw new UnsupportedOperationException("Not yet implemented"); 
} 
// 更 新 数据 ， 暂 未 实现 
(@Override 
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { 
throw new UnsupportedOperationException("Not yet implemented"); 
1 
ji 
既然 内 容 提供 器 是 四 大 组 件 之 一 ， 就 得 在 AndroidManifest.xml 中 注册 它 的 定义 ， 并 开放 
外 部 访问 权限 ， 注 册 代码 如 下 : 


«provider 





android:name-" provider.UserInfoProvider" 
android:authorities-"com.example.media.provider.UserInfoProvider" 
android:enabled-"true" 

android:exported-"true" /> 


注册 完毕 后 就 完成 了 服务 端 App 的 封装 工作 ， 接 下 来 可 由 其 他 App 进行 数据 存 取 。 
13.32 内容 解析 器 ContentResolver 


前 面 提 到 了 利用 ContentProvider 实现 服务 端 App 的 数据 封装 ， 如 果 客 户 端 App 想 访问 对 
方 的 内 部 数据 ， 就 要 通过 内 容 解析 器 ContentResolver 访问 。 内 容 解 析 器 是 客户 端 App 操作 服 
务 端 数据 的 工具 ， 相 对 应 的 内 容 提供 器 是 服务 端的 数据 接口 。 要 获取 ContentResolver 对 象 ， 
在 Activity 代码 中 调用 getContentResolver 方法 即 可 。 

ContentResolver 提供 的 方法 与 ContentProvider 是 一 一 对 应 的 ， 比 如 query. insert. update, 
delete、getType 等 方法 ， 连 方法 的 参数 类 型 都 一 模 一 样 。 其 中 ， 最 常用 的 是 query 函数 ， 调 用 
该 函数 返回 一 个 游标 Cursor 对 象 ， 这 个 游标 与 SQLite 的 游标 是 一 样 的 ， 想 必 读 者 早已 用 得 炉 
火 纯 青 。 

下 面 是 query 方法 的 具体 参数 说 明 《〈 依 顺序 排列 ) 。 


e uri: Uri 类 型 ， 可 以 理解 为 本 次 操作 的 数据 表 路 径 。 
e projection: 字符 串 数组 类 型 ， 指 定 将 要 查询 的 字段 名 称 列 表 。 
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e selection: 字符 串 类 型 ， 指 定 查询 条 件 。 

e selectionArgs: 字符 串 数 组 类 型 ， 指 定 查询 条 件 中 的 参数 取 值 列表 。 

e sortOrder: 字符 串 类 型 ， 指 定 排序 条 件 。 

针对 前 面 UserInfoProvider 提供 的 数据 接口 , 下 面 使 用 ContentResolver 在 客户 端 添加 用 户 
信息 ， 代 码 如 下 : 


private void addUser(ContentResolver resolver, UserInfo user) í 


j 











ContentValues name = new ContentValues(); 
name.put("name", user.name); 

name.put("age", user.age); 

name.put("height", user.height); 

name.put("weight", user. weight); 

name.put("married", false); 

name.put("update time", Utils.getNowDateTime()); 

II insert 的 第 一 个 参数 指明 了 要 访问 的 数据 源 
Tesolver.insert(UserlnfoContent.CONTENT_ URI, name); 


下 面 是 使 用 ContentResolver 在 客户 端 查询 所 有 用 户 信息 的 代码 : 


private String readAllUser(ContentResolver resolver) í 


} 


ArrayList<UserInfo> userArray = new ArrayList<UserInfo>(); 
// query 的 第 一 个 参数 指明 了 要 访问 的 数据 源 
Cursor cursor = resolver.query(UserInfoContent. CONTENT URI, null, null, null, null); 
while (cursor.moveToNext()) í 
UserInfo user = new Userlnfo(); 
user.name = cursor.getString(cursor.getColumnIndex(UserInfoContent. USER. NAME )); 
user.age = cursor.getInt(cursor.getColumnIndex(UserInfoContent. USER. AGE)); 
user.height = cursor getInt(cursor.getColumnIndex(UserInfoContent. USER. HEIGHT)); 
user.weight = cursor.getFloat(cursor.getColumnIndex(UserInfoContent. USER. WEIGHT)); 
userArray.add(user); 
h 
cursor.close(); 
String result = ""; 
for (int i-0; icuserArray;size(); i++) í 
UserInfo user = userArray.get(i); 
result = String.format("%s%s 年 龄 %d ”身高 %d ”体重 %f\n", result, 
user.name, user.age, Userheight user.weight); 
return result; 


添加 用 户 信息 的 效果 如 图 13-19 所 示 ， 一 开始 服务 端的 用 户 表 不 存在 用 户 记录 , 客户 端 使 




















H ContentResolver 添加 一 条 记录 后 ， 服 务 端的 用 户 记 录 数 返回 1。 用 户 信息 的 查询 明细 如 图 
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13-20 所 示 ， 点 击 页 面 上 的 用 户 记 录 数 量 文 字 ， 弹 出 一 个 对 话 框 ， 提 示 当 前 找到 的 所 有 用 户 的 
明细 数据 ， 包 括 姓 名 、 年 龄 、 身 高 、 体 重 等 信息 。 











25 
当前 共 找到 1 位 用 户 信息 
165 
T 阿 四 年 龄 25 身高 165 体 重 50.000000 


添加 用 户 信息 
当前 共 找 到 1 位 用 户 信息 


确定 








13-19. 利用 内 容 提供 器 添加 用 户 信息 13-20 利用 内 容 解析 器 查询 获得 用 户 信息 


在 实际 开发 中 ， 普 通 App 很 少 会 开放 数据 接口 给 其 他 应 用 访问 ， 作 为 服务 端 接口 的 
ContentProvider 基本 用 不 到 。 内 容 组 件 能 够 派 上 用 场 的 情况 往往 是 App 想 要 访问 系统 应 用 的 
通信 数据 ， 比 如 查看 联系 人 、 短 信 、 通 话 记录 ， 以 及 对 这 些 通信 信息 进行 增 、 删 、 改 、 查 。 

下 面 是 使 用 ContentResolver 添加 联系 人 信息 的 代码 片段 ， 此 时 访问 的 数据 来 源 变 成 了 系 
统 自 带 的 raw_contacts: 


public static void addContacts(ContentResolver resolver, Contact contact) { 
// 往 raw contacts 中 添加 数据 ， 并 获取 添加 的 id 号 
Uri raw uri = Uri.parse("content://com.android.contacts/raw_contacts"); 
ContentValues values = new ContentValues(); 
long contactId = ContentUris.parseld(resolver.insert(raw uri, values)); 


/ f£ data 中 添加 数据 (要 根据 前 面 获取 的 id 号 ) 

Uri uri = Uri.parse("content://com.android.contacts/data"); 
ContentValues name = new ContentValues(); 
name.put("raw contact id", contactld); 
name.put("mimetype", "vnd.android.cursor.item/name"); 
name.put("data2", contact.name); 

resolver.insert(uri, name); 


ContentValues phone = new Content Values(); 
phone.put("raw contact id", contactId); 
phone.put("mimetype", "vnd.android.cursor.item/phone v2"); 
phone. put(" data2", "2"; 

phone.put("datal", contact.phone); 

resolver.insert(uri, phone); 


ContentValues email = new ContentValues(); 
email.put("raw contact id", contactId); 
email.put("mimetype", "vnd.android.cursor.item/email v2"); 
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email.put("data2", "2"); 
email.put("datal", contact.email); 
resolver.insert(uri, email); 


j 


注意 上 述 代 码 用 了 4 条 insert 语句 ， 但 业务 上 只 添加 了 一 个 联系 人 信息 。 这 样 处 理 有 一 个 
问题 ， 就 是 4 个 insert 操作 不 在 同一 个 事务 中 ， 要 是 中 间 某 步 insert 操作 失败 ， 那 么 之 前 插入 
成 功 的 记录 就 无 法 自动 回 滚 ， 从 而 产生 垃圾 数据 。 

为 了 避免 这 种 情况 的 发 生 , Android 提供 了 内 容 操作 器 ContentProviderOperation 进行 批量 
数据 的 处 理 ， 即 在 一 个 请 求 中 封装 多 条 记录 的 修改 动作 , 然后 一 次 性 提交 给 服务 端 ， 从 而 实现 
在 一 个 事务 中 完成 多 条 数据 的 更 新 操作 。 即 使 某 条 记录 处 理 失败 ，ContentProviderOperation 也 
能 根据 事务 一 致 性 原则 自动 回 滚 本 事务 已 经 执行 的 修改 操作 。 

下 面 是 使 用 ContentProviderOperation 批量 添加 联系 人 信息 的 代码 片段 : 


public static void addFullContacts(ContentResolver resolver, Contact contact) { 
Uri raw uri = Uri.parse("content://com.android.contacts/raw contacts"); 
Uri uri = Uri.parse("content://com.android.contacts/data"); 
ContentProviderOperation op main — ContentProviderOperation 
.newInsert(raw uri).with Value("account name", null).build(); 
ContentProviderOperation op name — ContentProviderOperation 
.newInsert(uri).with ValueBackReference("raw contact id", 0) 
. with Value("mimetype", "vnd.android.cursor.item/name") 
.withValue("data2", contact.name).build(); 
ContentProviderOperation op phone = ContentProviderOperation 
.newInsert(uri).with ValueBackReference("raw contact id", 0) 
.with Value("mimetype", "vnd.android.cursor.item/phone v2") 
. with Value("data2", "2").withValue("datal", contact.phone).build(); 
ContentProviderOperation op email = ContentProviderOperation 
.newInsert(uri).with ValueBackReference("raw contact id", 0) 
. with Value("mimetype", "vnd.android.cursor.item/email v2") 
.with Value("data2", "2").withValue("data1", contact.email).build(); 
ArrayList«ContentProviderOperation? operations = new ArrayList«ContentProviderOperation?(); 
operations.add(op main); 








operations.add(op name); 
operations.add(op phone); 
operations.add(op email); 
ty ( 
resolver.applyBatch("com.android.contacts", operations); 
} catch (Exception e) í 
e.printStack Trace(); 








多 媒体 # 13 E 





添加 联系 人 信息 的 效果 如 图 13-21 和 图 13-22 所 示 。 其 中 , 图 13-21 所 示 为 添加 之 前 的 截图 ， 
此 时 联系 人 个 数 为 157 位 ; 图 13-22 所 示 为 添加 成 功 之 后 的 截图 ， 此 时 联系 人 个 数 为 158 位 。 


media 








[加 四 Ea 


15960238696 15960238696 








aaa@163.com aaa@163.com 


添加 联系 人 添加 联系 人 
当前 共 找 到 157 位 联系 人 当前 共 找到 158 位 联系 人 





图 13-21 联系 人 添加 之 前 的 界面 图 13-22 联系 人 添加 之 后 的 界面 
13.33 内容 观察 器 ContentObserver 


ContentResolver 获取 数据 采用 的 是 主动 查询 方式 ， 有 查询 就 有 数据 , 没 查询 就 没 数据 。 有 
时 我 们 不 但 要 获取 以 往 的 数据 ， 还 要 实时 获取 新 增 的 数据 ， 最 常见 的 业务 场景 是 短信 验证 码 。 
电 商 App 经 常 在 用 户 注册 或 付款 时 发 送 验证 码 短信 ， 为 了 给 用 户 省 事 ，App 通常 会 监控 手机 
刚 收 到 的 验证 码 数 字 ， 并 自动 填 入 验证 码 输入 框 。 这 时 就 用 到 了 内 容 观 察 器 ContentObserver， 
给 目标 内 容 注 册 一 个 观察 器 ， 目 标 内容 的 数据 一 旦 发 生变 化 ， 观 察 器 规定 好 的 动作 马上 触发 ， 
从 而 执行 开发 者 预先 定义 的 代码 。 

内 容 观察 器 的 用 法 与 内 容 提供 器 类 似 ， 也 要 从 ContentObserver 派生 一 个 观察 器 类 ， 然 后 
通过 ContentResolver 对 象 调用 相应 的 方法 注册 或 注销 观察 器 。 下 面 是 ContentResolver 与 观察 
器 有 关 的 方法 说 明 。 

e registerContentObserver: 注册 内 容 观察 器 。 

e unregisterContentObserver: 注销 内 容 观 察 器 。 

e notifyChange: 通知 内 容 观察 器 发 生 了 数据 变化 。 


为 了 让 读者 更 好 理解 ， 下 面 举 一 个 实际 应 用 的 例子 。 在 第 6 章 的 实战 项 目 “ 手 机 安全 助 
手 ” 中, 每 月 的 流量 限额 由 用 户 手 动 配置 , 但 流量 限额 其 实 是 由 移动 运营 商 指 定 的 。 以 中 国 移 
动 为 例 ， 只 要 发 送 流量 校准 短信 给 运营 商 客服 号 码 ( 如 发 送 18 到 10086) ， 运 营 商 就 会 给 用 
户 发 送 本 月 的 流量 数据 ,包括 月 流量 额度 、 已 使 用 流量 、 未 使 用 流量 等 信息 。 安 全 助手 只 需 监 
控 10086 发 送 的 短信 内 容 ， 即 可 自动 获取 手机 号 码 的 月 流量 额度 ， 无 须 用 户 手 工 配置 。 

下 面 是 利用 ContentObserver 实现 流量 校准 的 代码 片段 : 

private Handler mHandler = new Handler(); 
private SmsGetObserver mObserver; 
private static Uri mSmsUri; 

private static String[]] mSmsColumn; 





(&)TargetApi(Build. VERSION. CODES.KITKAT) 
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private void initSmsObserver() í 
if (Build VERSION.SDK INT >= Build. VERSION CODES.KITKAT) í 
mSmsUri = Telephony.Sms.Inbox. CONTENT URI; 
mSmsColumn = new String[] í 
Telephony.Sms. ADDRESS, Telephony.Sms.BODY, Telephony.Sms.DATE }; 
} else í 
mSmsUri = Uri.parse("content://sms/inbox"); 
mSmsColumn = new String[] í "address", "body", "date" j; 
j 
mObserver = new SmsGetObserver(this, mHandler); 
getContentResolver().registerContentObserver(mSmsUri, true, mObserver); 


@Override 

protected void onDestroy() { 
getContentResolver().unregisterContentObserver(mObserver); 
super.onDestroy(); 

h 


private static class SmsGetObserver extends ContentObserver í 
private Context mContext; 
public SmsGetObserver(Context context, Handler handler) { 
super(handler); 
mContext = context; 


@Override 
public void onChange(boolean selfChange) { 
String sender = ""; 
String content 
String selection = String.format("address='10086' and date>%d", 
System.currentTimeMillis()-1000*60*60); 
Cursor cursor = mContext.getContentResolver().query( 





mSmsUri, mSmsColumn, selection, null, " date desc"); 

while(cursor.moveToNext()) í 

sender = cursor.getString(0); 

content = cursor.getString(1); 

break; 
j 
cursor.close(); 
if (pd != null && pd.isShowing() = true) í 

pd.dismiss(); 
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剩余 : 


// 回 调 短信 监听 方法 

mCheckResult = String.format(" 发 送 号 码 : %s\n 短信 内 容 : %s", sender, content); 
Log.d(TAG, "result-"-mCheckResult); 

String flow = String.format(" 流 量 校准 结果 如 下 : mt 总 流量 为 : %s\n\t 已 使 用 : Sos Nc 


%s", 


findFlow(content, "总 流量 为 ", "MB"), 

findFlow(content, "已 使 用 ", "MB"), findFlow(content, "剩余 ", "MB")); 
tv check flow.setText(flow); 
super.onChange(selfChange); 


private static String findFlow(String sms, String begin, String end) í 
int begin pos = sms.indexOf(begin); 
if (begin pos < 0) ( 
return "未 获取 "; 
j 
String sub sms = sms.substring(begin pos); 
intend pos sub sms.indexOf(end); 
if(end pos < 0) í 
return "未 获取 "; 
5 
String flow desc = sub sms.substring(begin.length(), end pos-*end.length()); 
return flow desc; 


} 


流量 校准 的 效果 如 图 13-23 和 图 13-24 所 示 。 其 中 ， 图 13-23 所 示 为 用 户 实际 收 到 的 短信 


内 容 ， 图 13-24 所 示 为 App 监视 短信 并 解析 完成 的 流量 数据 页 面 。 


10086 


您 好 ! AE IKE 流量 
为 599.89MB。 

Toesig Hoho, 您 办 理 的 
套餐 内 全 移动 数据 总 流量 

为 168175.89MB， 已 使 用 3 

余 168143.02MB ( 其 

用 32.87MB， 副 号 1 ( 

使 用 0.00MB ) 其 中 国内 流 : 

余 16B143.02MB ( pee 

量 567.20MB ) 。 回 复 "18* 月 份 # 查询 相应 
月 份 移动 数 信用 全， 回 


进行 流量 校准 


流量 校准 结 
总 流量 为 : MB 
已 使 用 : 32.87MB 

剩余 : 1GB143.02MB 








图 13-23 ”用 户 收 到 的 短信 内 容 图 13-24 内 容 观察 器 监视 并 解析 得 到 的 流量 信息 
一 下 在 Content 组 件 经 常 使 用 的 系统 URI， 详 细 的 URI 取 值 说 明 见 表 13-4。 
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表 13-4 ”常用 的 系统 URI 取 值 说 明 






































内 容 名 称 URI 常量 名 实际 路 径 
联系 人 ContactsContract.Contacts. CONTENT URI content://com.android.contacts/ 
contacts 

联系 人 电话 ContactsContract.CommonDataKinds. content://com.android.contacts/data/ 
Phone.CONTENT URI phones 

联系 人 邮箱 ContactsContract.CommonDataKinds. content://com.android.contacts/data/ 
Email.CONTENT URI emails 

SIM 卡 联系 人 content://icc/adn 

短信 Telephony.Sms.CONTENT URI content://sms 

彩信 Telephony.Mms.CONTENT URI content://mms 

通话 记录 CallLog.Calls. CONTENT URI content://call log/calls 

收 件 箱 Telephony.Sms.Inbox. CONTENT URI (短信 相关 的 URI) | content://sms/inbox 

已 发 送 Telephony.Sms.Sent.CONTENT_URI (短信 相关 的 URI) | content://sms/sent 

草稿 条 Telephony.Sms.Draft CONTENT_URI (短信 相关 的 URI) | content:/sms/draft 

发 件 箱 TelephonySms.Outbox.CONTENT _URI( 短 信 相 关 的 URI) | content://sms/outbox 

发 送 失败 无 content://sms/failed 

待 发 送 列表 无 。 比 如 开启 飞行 模式 后 ， 该 短信 就 在 待 发 送 列表 里 content://sms/queued 

13.4 实战 项 目 : 音乐 播放 器 一 一 浪花 音乐 
又 到 每 章 结尾 的 实战 项 目 时 间 了 。 手 机 上 的 多 媒体 内 容 讲究 声 情 并 茂 、 悦 目 且 悦耳 ， 这 





样 才能 让 用 户 的 感官 得 到 最 大 享受 。 影 视 播 放 器 由 于 存在 视频 自身 的 画面 , 反而 限制 了 开发 者 
的 施展 空间 ; 而 音乐 播放 器 允许 定制 播放 画面 ， 开 发 者 有 足够 空间 施展 拳脚 。 本 章 以 “音乐 播 














放 器 浪花 音乐 ”为 压轴 实战 项 目 , 通过 该 项 目的 编码 练习 巩固 和 提高 开发 者 的 实战 技能 。 
13.4.1 设计 思 


大 家 常见 的 主流 音乐 播放 器 (如 QQ 音乐 、 酷 狗 音乐 、 栈 我 音乐 、 虾米 音乐 、 百 度 音乐 等 ) 
不 外 乎 有 3 项 播放 功能 : 

(1) 展示 音乐 和 歌曲 列表 。 

(2) 歌曲 详情 页 面 滚 动 展示 歌词 ， 并 高 亮 显示 当前 正在 播放 的 歌词 片段 。 

(3) 通过 音乐 控制 条 显示 播放 进度 ， 并 提供 开始 与 暂停 、 拖 动 播放 的 功能 。 

只 看 文字 描述 有 点 抽象 ,还 是 先 给 出 播放 器 的 效果 图 ， 方便 查找 对 应 的 功能 。 图 13-25 所 
示 为 播放 器 的 歌曲 列表 页 面 ， 点 击 项 部 的 “打开 音乐 文件 ”会 弹出 文件 对 话 框 ， 用 于 选择 音频 
文件 ; 底部 是 播放 器 的 控制 条 ， 中间 为 当前 手机 上 的 所 有 音乐 文件 列表 。 点 击 某 个 音乐 项 ,， 进 
入 该 音乐 的 详情 页 面 ， 如 图 13-26 所 示 。 页 面 顶部 显示 歌曲 名 称 和 演唱 者 ， 页 面 底部 是 播放 器 
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控制 条 ， 页 面 中 间 为 该 歌曲 对 应 的 歌词 内 容 。 





图 13-25 ”播放 器 的 歌曲 列表 页 面 图 13-26 播放 器 的 歌曲 详情 页 面 


接 下 来 对 音乐 播放 器 的 3 项 功能 进行 详细 剖析 。 
对 于 第 一 点 的 展示 歌曲 列表 ， 让 用 户 手动 添加 不 但 费时 费力 ， 而 且 用 户 往往 搞 不 清楚 手 
机 上 的 歌曲 都 放 在 哪个 目录 。 我 们 假设 用 户 是 “ 傻 白 甜 ”， 开 发 者 做 的 App 就 得 智能 贴心 ， 
主动 帮 用 户 把 手机 上 的 歌曲 找 出 来 。 要 想 实现 这 个 功能 , 可 以 通过 内 容 组 件 访问 系统 自 带 的 媒 
体 库 ， 查 找 并 显示 媒体 库 中 的 歌曲 列表 。 
对 于 第 二 点 的 滚动 歌词 显示 ， 常 见 的 歌词 文件 是 LRC 格式 的 文本 文件 ， 内 容 主要 是 每 名 
歌词 的 文字 与 开始 时 间 。 文 本 文件 的 解析 并 不 复杂 ,难点 主要 是 滚动 显示 。 乍 看 歌词 从 下 往 上 
滚动 ， 适合 采 用 平移 动画 ， 然 而 歌词 滚动 不 是 匀速 的 ， 因 为 每 句 歌词 的 间隔 时 间 并 不 固定 ， 只 
能 把 整个 歌词 滚动 分 解 为 若干 动画 ， 有 多 少 行 就 有 多 少 个 动画 。 
对 于 第 三 点 的 音乐 控制 条 ， 总 体 上 使 用 前 面 提 到 的 视频 控制 条 。 不 过 音乐 控制 条 更 加 复 
杂 ， 因 为 除了 控制 音频 的 播放 ,还 要 控制 歌词 动画 的 播放 。 另 外 ,音乐 控制 条 显示 在 歌曲 列表 
页 面 上 ， 为 了 与 主流 播放 器 看 齐 ， 最 好 在 系统 通知 栏 固定 放置 音乐 控制 条 。 
弄 履 了 音乐 播放 器 的 主要 功能 ， 再 来 看 该 播放 器 用 到 的 App 开发 技术 。 读 者 能 从 第 一 章 

- 直 看 到 本 章 ， 学 习 的 耐心 真是 很 好 。 如 果 用 到 前 面 章 节 的 知识 点 ， 这 里 就 一 起 列举 出 来 。 笔 

者 先 抛砖引玉 ， 读 者 发 现 遗 漏 的 地 方 可 加 以 补充 。 


CD 服务 Service: 歌曲 播放 不 依赖 于 某 个 页 面 ， 即 使 用 户 回 到 桌面 , 歌曲 也 要 继续 播放 ， 
因此 必须 在 后 台 服 务 中 播放 歌曲 。 

(2) 应 用 Application: 正在 播放 的 歌曲 名 称 ， 在 播放 器 的 任何 页 面 都 能 看 到 ， 用 到 了 全 
局 内 存 ， 要 把 歌曲 名 称 保存 在 自 定 义 的 Application 类 中 。 

G) 内 容 解析 器 ContentResolver: 系统 媒体 库 中 的 音频 文件 ， 需 要 通过 内 容 解析 器 访问 
媒体 库 的 音频 资源 ， 详 细 路 径 是 MediaStore.Audio.Media.EXTERNAL CONTENT URI. 

(4) 文件 存 取 : 歌词 文件 与 音乐 文件 在 同一 个 目录 下 , 文件 名 一 样 , 只 是 扩展 名 变 为 lrc。 

C5) 通知 Notify: 系统 通知 栏 要 显示 音乐 控制 条 ， 就 得 把 后 台 服 务 以 通知 的 形式 在 前 台 
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运行 。 

(6) 媒体 播放 器 MediaPlayer: 播放 音频 文件 ， 自 然 会 用 到 媒体 播放 器 。 

CD) 按键 事件 KeyEvent: 用 户 按 手机 侧面 的 加 、 减 键 ， 播 放 器 应 弹出 音量 调节 对 话 框 ， 
供用 户 调 整 音量 大 小 。 

(8) 动画 Animation: 歌词 的 滚动 显示 ， 可 使 用 平移 动画 ， 也 可 使 用 属性 动画 实现 平移 
效果 。 

(9) 其 余 高 级 控件 ， 如 列表 视图 ListView, HEREZ ProgressBar、 拖 动 条 SeekBar 等 ， 有 

不 看 不 知道 ， 一 看 吓 一 跳 。 如 果 仅 播放 声音 ， 技 术 上 只 要 Activity 加 MediaPlayer 就 行 ， 
最 多 再 加 一 个 媒体 控制 条 MediaController， 三 板斧 够 用 了 。 但 是 要 让 播放 器 变 得 生动 活泼 ， 要 
让 用 户 真 正 去 欣赏 音乐 ,开发 者 要 做 的 工作 就 不 是 实现 基础 功能 , 而 是 从 界面 设计 到 用 户 体验 ， 
每 个 细节 都 要 充分 考虑 ， 所 以 实际 运用 的 技术 远 远 不 止 三 板斧 。 





13.4. ”小 知识 : 可 变 字 符 串 SpannableString 


大 家 都 知道 ， 文 本 控件 家 族 显示 文本 内 容 使 用 setText 方法 ， 使 用 setTextColor 方法 设置 
文本 颜色 , 使 用 setTextSize 方法 设置 文本 大 小 , 使 用 setTextAppearance 方法 设置 文本 样式 ( 包 
括 颜 色 、 大 小 、 风 格 等 ) 。 普 通 的 用 法 只 能 对 控件 的 所 有 文本 做 统一 设置 ， 如 果 想 对 前 一 段 文 
本 加 大 加 粗 ， 对 中 间 一 段 文 本 显示 红色 ， 再 将 后 面 一 段 文本 换 成 图 像 ， 就 无 能 为 力 了 。 为 了 解 
决 分 段 文 本 使 用 不 同样 式 的 需求 ，Android 提供 了 可 变 字符 串 SpannableString， 通 过 该 工具 实 
现 对 文本 分 段 显示 。 

SpannableString 的 原理 是 给 指定 位 置 的 文本 赋予 对 应 的 样式 , 从 而 告知 系统 这 段 文本 的 显 
示 方 式 。 具 体 到 编码 有 3 个 步骤 ， 说 明 如 下 : 

€KED 从 指定 文本 字符 串 构造 一 个 SpannableString 对 象 。 

CX02 调用 SpannableString 对 象 的 setSpan 方法 设置 指定 文本 段 的 显示 风格 。 该 方法 的 第 一 个 
参数 为 风格 样式 对 象 ， 第 二 个 参数 为 文本 段 的 起 始 位 置 ， 第 3 个 参数 为 文本 段 的 终止 位 置 ， 第 4 个 参 
数 为 风格 的 范围 标志 , 用 来 标识 在 文本 段 前 后 输入 新 字符 时 是 否 令 它们 应 用 这 个 风格 (主要 对 EditText 
起 作用 ) 。 风 格 范围 标志 的 取 值 说 明 见 表 13-5。 

E 调用 文本 控件 对 象 的 setText 方法 设置 定义 好 的 SpannableString 对 象 。 



























































表 13-5 风格 范围 标志 的 取 值 说 明 


Spanned 类 的 范围 标志 说 明 
SPAN EXCLUSIVE EXCLUSIVE 前 后 都 不 包括 





SPAN_INCLUSIVE EXCLUSIVE 
SPAN EXCLUSIVE INCLUSIVE 
SPAN INCLUSIVE INCLUSIVE 


前 面包 括 ， 后 面 不 包括 
前 面 不 包括 ， 后 面包 括 
前 后 都 包括 











显示 风格 的 定义 在 android.textstyle 包 中 , 总 共有 30 多 个 。 当 然 ， 常 用 的 没 这 么 多 , 笔者 
整理 了 8 个 常用 的 显示 风格 ， 详 见 表 13-6. 
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表 13-6 ”常用 的 显示 风格 类 列表 
可 变 字符 串 的 显示 风格 类 | 说 明 
































RelativeSizeSpan 设置 文字 大 小 。1.0 表示 正常 大 小 ，0.5 表示 缩小 到 原来 的 一 半 ，2.0 表示 放大 到 
原来 的 两 倍 

StyleSpan 设置 文字 字体 。 字 体 风格 的 取 值 说 明 见 表 13-7 

ForegroundColorSpan 设置 文字 的 颜色 

BackgroundColorSpan 设置 文字 的 背景 色 

UnderlineSpan 给 文字 加 下 划 线 

StrikethroughSpan 给 文字 加 删除 线 

ImageSpan 把 文字 替换 为 图 片 

URLSpan 给 文字 添加 超 链接 





表 13-7 字体 风格 的 取 值 说 明 








Typeface 类 的 字体 风格 说 明 

NORMAL 正常 字体 

BOLD 加 粗 字 体 

ITALIC 倾斜 字体 

BOLD ITALIC 既 加 粗 又 设置 为 斜体 





下 面 是 使 用 SpannableString 设置 文字 样式 的 代码 : 


public class SpannableActivity extends AppCompatActivity í 
private Text View tv_spannable; 
private String mText = "为 人 民 服 务 "; 
private String mKey = "A R"; 
private int mBeginPos, mEndPos; 


(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity spannable); 
tv spannable = (TextView) find ViewById(R.id.tv spannable); 
tv spannable.setText(mText); 
mBeginPos = mText.indexOf( mKey); 
mEndPos = mBeginPos + mKey.length(); 
initSpannableSpinner(); 


private void initSpannableSpinner() í 
ArrayAdapter-String^ spannableAdapter = new ArrayAdapter-String^(this, 
R.layout.item select, spannableArray); 
Spinner sp spannable = (Spinner) findViewById(R.id.sp spannable); 
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sp_spannable.setPrompt(" 可 变 字 符 串 样式 : "); 
sp_spannable.setAdapter(spannableAdapter); 

sp spannable.setOnItemSelectedListener(new SpannableSelectedListener()); 
sp spannable.setSelection(0); 


private String[] spannableArray-( 
" 增 大 字号 ", "加 粗 字体 ", "前 景 红色 ", "背景 绿色 ", "下 划 线 ", "表情 图 片 " }; 
class SpannableSelectedListener implements OnltemSelectedListener í 
public void onItemSelected(AdapterView-?- arg0, View arg], int arg2, long arg3) í 
SpannableString spanText — new SpannableString(mText); 
if(arg2 — 0) ( 
spanText.setSpan(new RelativeSizeSpan(1.5f), mBeginPos, mEndPos, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
} else if (arg2 = 1) í 
spanText.setSpan(new StyleSpan(Typeface.BOLD), mBeginPos, mEndPos, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
} else if (arg2 = 2) ( 
spanText.setSpan(new ForegroundColorSpan(Color.RED), mBeginPos, 
mEndPos, Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
} else if (arg? = 3) í 
spanText.setSpan(new BackgroundColorSpan(Color.GREEN), mBeginPos, 
mEndPos, Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
) else if (arg2 = 4) { 
spanText.setSpan(new UnderlineSpan(), mBeginPos, mEndPos, 
Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
) else if (arg2 = 5) í 
spanText.setSpan(new ImageSpan(SpannableActivity.this, R.drawable.people), 
mBeginPos, mEndPos, Spanned.SPAN EXCLUSIVE EXCLUSIVE); 
j 
tv spannable.setText(spanText); 


public void onNothingSelected(AdapterView-?- arg0) í 
; 


j 


SpannableString 的 不 同 风格 效果 如 图 13-27 一 图 13-32 所 示 。 其 中 ， 图 13-27 所 示 为 加 大 
字体 后 的 效果 ， 图 13-28 所 示 为 加 粗 字 体 后 的 效果 ， 图 13-29 所 示 为 修改 文字 颜色 后 的 效果 ， 
图 13-30 所 示 为 修改 文字 背景 后 的 效果 ， 图 13-31 所 示 为 增加 下 划 线 后 的 效果 ， 图 13-32 所 示 
为 把 文字 替换 成 图 片 后 的 效果 。 
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可 变 字符 串 样式 : 增 大 字号 可 变 字符 串 样式 : 加 粗 字体 z 
为 人 民 服 务 DOSE 
图 13-27 增 大 字体 的 风格 图 13-28 ”加 粗 字体 的 风格 


可 变 字符 串 样式 : 前 景 红 色 x 可 变 字符 串 样式 : 背景 绿色 
为 人 民 服 务 为 网 图 服务 


图 13-29 ”修改 文字 颜色 的 风格 图 13-30 修改 文字 背景 色 的 风格 





可 变 字符 串 样式 : 下 划 线 T 可 变 字 符 串 样 式 : 表情 图 片 


为 人 民 服 务 


sides 





1331 添加 下 划 线 的 风格 图 13-32 图 片 替换 文字 的 风格 
读者 是 否 对 图 13-32 似曾相识 ?使 用 QQ 聊天 时 会 自动 把 特定 字符 转 成 表情 图 片 , 比如 把 
文字 内 容 中 的 “:)” 显 示 为 笑脸 图 片 ， 在 Android 设备 上 可 通过 SpannableString 实现 该 功能 。 
13.4.3 ”代码 示例 


编码 与 测试 方面 需要 注意 以 下 5 点 : 
(1) 如 果 把 动画 描述 定义 在 XML 文件 中 ， 动 画 定义 文件 就 要 放 在 res/anim 目录 下 。 
(OD 打开 音乐 文件 ， 要 记得 为 AndroidManifest.xml 添加 SD 卡 的 权限 配置 : 





<!--SD 卡 -> 
<uses-permission android:name-"android.permission. WRITE EXTERNAL STORAGE" > 
«uses-permission android:name-"android.permission.READ EXTERNAL STORAGE" /> 
«uses-permission android:name-"android.permission MOUNT UNMOUNT FILESYSTEMS" > 
(3) AndroidManifest.xml 的 application 节点 注意 补充 android:name-".MainA pplication"; 
另外 ， 注 册 音 乐 播放 服务 的 service， 注 册 代 码 如 下 : 


«service android:name-" service.MusicService" android:enabled="true" /> 
(4) 测试 设备 的 Android 版 本 要 求 不 低 于 Android 4.4.2， 因 为 属性 动画 的 暂停 和 恢复 方 
法 是 在 4.4.2 后 引入 的 。 
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(5) 要 在 真 机 上 测试 实战 项 目 ， 如 果 在 模拟 器 上 测试 ， 就 会 发 现 MP3 标题 乱码 。 这 是 因 
为 中 文 歌曲 的 MP3 标签 采用 GBK 编码 ， 而 模拟 器 采用 UTF8 编码 , 两 者 对 汉字 的 编码 格式 不 
- 致 。 如 果 用 真 机 测试 ， 国 产 机 厂商 已 经 帮 我 们 解决 了 汉字 编码 问题 。 

具体 的 代码 编写 还 存在 3 个 技术 要 点 ， 记 录 如 下 : 

1. 使 用 内 容 解析 器 ContentResolver 访问 媒体 库 

音频 资源 对 应 的 内 容 路 径 是 MediaStore.Audio.Media.EXTERNAL _CONTENT_URI， 内 容 
解析 器 通过 query 方法 访问 该 URI 获 得 记录 游标 , 还 得 把 详细 记录 字段 逐个 读 取出 来 , 音频 资 
源 的 字段 信息 说 明 见 表 13-8。 





表 13-8 ”音频 资源 的 字段 信息 说 明 














MediaStore 类 的 音频 资源 字段 说 明 

Audio.Media. ID. 歌曲 编号 
Audio.Media.TITLE 歌曲 的 标题 名 称 
Audio.Media.ALBUM 歌曲 的 专辑 名 称 
Audio.Media.DURATION 歌曲 的 播放 时 间 
Audio.Media.SIZE 歌曲 文件 的 大 小 
Audio.Media.ARTIST 歌曲 的 演唱 者 
Audio.Media. DATA 歌曲 文件 的 完整 路 径 


2. 解析 LRC 歌词 文件 


简要 介绍 一 下 LRC 文件 的 内 容 格式 ， 开 发 者 关心 的 主要 是 内 部 的 时 间 信 息 与 歌词 文字 。 
下 面 是 一 个 LRC 歌词 的 片段 : 

[offset:500] 

[00:26.53] 真 情 像 草 原 广阔 

[00:32.78] 层 层 风 雨 不 能 阻隔 

[00:38.87] 总 有 云 开 日 出 时 候 

[00:45.68] 万 丈 阳光 照耀 你 我 

[02:26.49][00:51.68] 真 情 像 梅花 开 过 

[02:32.68][00:57.94] 冷 冷 冰 雪 不 能 掩 没 


歌词 第 一 行 有 一 个 offset 标签 , 表示 歌词 标注 的 时 间 与 音乐 文件 的 时 间 偏 移 。 歌词 行 的 前 
面 是 中 括号 括 起 来 的 时 间 戳 ， 时 间 戳 的 数据 格式 为 “分 : 秒 .毫秒 ”, 表示 该 行 歌词 的 起 始 时 间 。 
如 果 某 行 歌词 被 演唱 多 遍 ， 那 么 歌词 文字 前 面 会 有 多 个 时 间 戳 。 

3. 歌词 滚动 动画 的 播放 控制 

- 般 动 画 启动 后 很 快 就 会 结束 ， 但 歌词 滚动 动画 不 是 这 样 的 ， 用 户 点 击 控制 条 上 的 暂停 
按钮 ， 不 但 播放 器 要 暂停 播放 ， 而 且 歌 词 要 和 暂停 滚动 。 平 移动 画 TranslateAnimation 不 支持 暂 
停 和 恢复 操作 , 不止 平移 动画 , 所 有 补 间 动画 都 不 支持 暂停 和 恢复 。 难 道 要 自己 重 定义 动画 ? 
山 穷 水 尽 疑 无 路 ， 柳 上 暗 花 明 又 一 村 。 幸 好 Android 提供 了 属性 动画 ， 不 但 支持 所 有 补 间 动画 效 
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果 , 而 且 支 持 暂停 和 恢复 操作 ,还 等 什么 , 赶紧 把 TranslateAnimation 换 成 ObjectAnimator 吧 ! 
现在 音乐 播放 器 的 编码 没什么 难点 ， 如 果 不 出 状况 ,读者 就 能 很 快 看 到 自己 的 App 作品 。 
图 13-33 所 示 为 音乐 播放 器 的 效果 画面 。 点 击 歌曲 列表 中 的 歌 名 《一 剪 梅 》， 进 入 该 歌曲 的 播 
放 界面 ， 歌 词 文字 随 着 时 间 流 逝 缓慢 向 上 滚动 ， 当 前 演唱 的 歌词 行 会 高 亮 显示 。 播 放 一 段 时 间 后 ， 
控制 条 的 进度 移 到 右边 ， 歌 词 也 大 半 上 翻 ， 高 亮 的 歌词 行 移 向 后 面 的 文字 ， 如 图 13-34 所 示 。 





图 13-33 一剪梅 开始 播放 E1334 一剪梅 正 在 播放 
接着 按 返 回 键 ， 后 退 到 歌曲 列表 页 面 ， 页 面 下 方 的 控制 条 显示 当前 的 播放 进度 ， 时 间 计 
数 随 着 歌曲 播放 而 不 断 刷新 ， 如 图 13-35 所 示 。 在 歌曲 列表 页 面 点 击 歌 名 《上 海滩 》， 进 入 该 
歌曲 的 播放 界面 ， 此 时 《一 剪 梅 》 停 止 播放 ， 转 为 播放 《上 海滩 》， 如 图 13-36 所 示 。 























13-35 ” 回 到 歌曲 列表 页 面 13-36 ”开始 播放 上 海滩 


最 后 下 拉 系 统 通知 栏 ， 应 该 能 够 看 到 播放 器 的 控制 条 ， 如 图 13-37 所 示 。 在 通知 栏 上 不 但 
可 以 自动 刷新 播放 进度 ， 而 且 可 以 进行 暂停 和 恢复 播放 的 操作 。 
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图 13-37 通知 栏 上 的 音乐 控制 条 
下 面 是 音乐 播放 界面 的 代码 : 


(G/TargetApi(Build. VERSION CODES.KITKAT) 
public class MusicDetailActivity extends AppCompatActivity implements 
AnimatorListener, OnSeekChangeListener, VolumeA djustListener í 
private static final String TAG = "MusicDetailActivity"; 
private TextView tv title; 
private TextView tv artist; 
private TextView tv music; 
private MusicInfo mMusic; 
private AudioController ac. play; 
private LyricsLoader mLoader; 
private ArrayListcLrcContent* mLrcList; 
private AudioManager mAudioMgr; 
private VolumeDialog dialog; 
private MainApplication app; 
private Handler mHandler = new Handler); 


(à Override 
protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity music detail); 
tv title = (TextView) findViewById(R.id.tv title); 
tv artist = (Text View) find ViewById(R.id.tv artist); 
tv music = (TextView) find ViewById(R.id.tv music); 
ac play = (AudioController) find ViewById(R.id.ac play); 
ac play.setOnSeekChangeL istener(this); 
mMusic = getIntent().getParcelableExtra("music"); 
tv title.setText(mMusic.getTitle()); 
tv artist.set Text(mMusic.getArtist()); 
mLoader = LyricsLoader.getInstance(mMusic.getUrl()); 
mLrcList = mLoader.getLrcList(); 
mLineHeight = Math.round(MeasureUtil.getTextHeight(" 4", tv music.getTextSize())); 
mAudioMgr = (AudioManager) getSystemService(Context.AUDIO SERVICE); 
app = MainApplication.getInstance(); 
playMusic(); 


@Override 
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protected void onDestroy() í 


super.onDestroy(); 
mHandler.removeCallbacksAndMessages(null); 


private int frequence = 8000; 
private int channelConfig = AudioFormat.CHANNEL IN STEREO; 
private int audioFormat = AudioFormat.ENCODING PCM I6BIT; 
// 播放 歌曲 
private void playMusic() í 
Log.d(TAG, "song="+mMusic.getTitle()); 
if (Utils.getExtendName(mMusic.getUrl()).equals("pcm")) í 
ac_play.setVisibility(View.GONE); 
AudioPlayTask playTask = new AudioPlayTask(); 
playTask.execute(mMusic.getUrl(), ""+frequence, ""+channelConfig, ""+audioFormat); 


yelse í 
/下 面 处 理 歌词 
if (mLoader.getLrcList()!=null && mLreList.size()>0) í 
mLrcStr = ""; 
for (int i-0; i<mLrcList.size(); i++) í 
LrcContent item = mLrcList.get(i); 
mLrcStr = mLreStr + item.getLreStr() + "n"; 
j 
tv music.setText(mLreStr); 
tv music.setAnimation(AnimationUtils.loadAnimation(this,R.anim.alpha music)); 
H 
/播放 音乐 


if (app.mFilePath==null || 'app.mFilePath.equals(mMusic.getUrl())) í 
Intent intent = new Intent(this, MusicService.class); 
intent.putExtra("is play", true); 
intent.putExtra(" music", mMusic); 


startService(intent); 
mHandler.postDelayed(mRefreshLrc, 150); 

} else { 
onMusicSeek(0, app.mMediaPlayer.getCurrentPosition()); 

; 

mHandler.postDelayed(mRefreshCtrl, 100); 

j| 
// 刷 新 进度 条 


private Runnable mRefreshCtrl = new Runnable() í 
@Override 
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public void run() í 
ac play.setCurrentTime(app.mMediaPlayer.getCurrentPosition(), 0); 
if (app.mMediaPlayer.getCurrentPosition() >= app.mMediaPlayer.getDuration()) í 
ac play.setCurrentTime(0, 0); 
j 
mHandler.postDelayed(this, 500); 


h 


private int mCount — 0; 
private float mCurrentHeight — 0; 
private float mLineHeight — 0; 
/计算 每 行 歌词 的 动画 
private Runnable mRefreshLrc = new Runnable() í 
@Override 
public void run() { 
if (mLoader.getLrcList()==null || mLrcList.size()<=0) í 
return; 
; 
int offset = mLrcList.get(mCount).getLrcTime() 
- ((ImCount==0)?0:mLrcList.get(mCount-1).getLrcTime()) - 50; 
if (offset <= 0) í 
return; 


j 
startAnimation(mCurrentHeight - mLineHeight, offset); 


h 


private int mPrePos = -1, mNextPos = 0; 
private String mLrcStr; 
private ObjectAnimator animTranY; 
/歌词 滚动 动画 
public void startAnimation(float aimHeight int offset) í 
animTranY = ObjectAnimator.ofFloat(tv music, "translationY", mCurrentHeight, aimHeight); 
animTranY.setDuration( offset); 
animTranY.setRepeatCount(0); 
animTranY.addListener(this ); 
animTranY.start(); 
mCurrentHeight = aimHeight; 
if (app.mMediaPlayer.isPlaying() != true) í 
mHandler.postDelayed(new Runnable() í 
(a Override 
public void run() í 
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animTranY.pause(); 


; 
}, offset-- 100); 


@Override 
public void onAnimationStart(Animator animation) { 


j 


@Override 
public void onAnimationEnd(Animator animation) { 
if (mCount < mLrcList.size()) í 
mNextPos = mLreStr.indexOf("\n", mPrePos-1); 
SpannableString spanText = new SpannableString(mLrcStr); 
spanText.setSpan(new ForegroundColorSpan(Color.R ED), mPrePos+1, 
mNextPos>0?mNextPos:mLrcStr.length()-1, Spanned.SPAN EXCLUSIVE - 
EXCLUSIVE); 
mCount++; 
tv music.setText(spanText); 
if (mNextPos > 0 && mNextPos < mLreStr.length()-1) í 
mPrePos = mLrcStr.indexOf(" n", mNextPos); 
mHandler.postDelayed(mRefreshLrc, 50); 


(@Override 
public void onAnimationCancel( Animator animation) { 


j 


@Override 
public void onAnimationRepeat(Animator animation) { 


j 


/音乐 控制 条 的 拖 动 操作 
@Override 
public void onMusicSeek(int current, int seekto) { 
Log.d(TAG, "current="+current+", seekto="+seekto); 
if (animTranY != null) { 
animTran Y.cancel(); 


i 
mHandler.removeCallbacks(mRefreshL rc); 
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inti; 
for (i70; i«mLrcList.size(); i++) í 
LrcContent item = mLrcList.get(i); 
if (item.getLrcTime() > seekto) í 
break; 


; 
mCount = i; 
mPrePos = -1; 
mNextPos = 0; 
if (mCount > 0) í 
for (int j = 0; j < mCount; j+) { 
mNextPos = mLrcStr.indexOf("n", mPrePos + 1); 
mPrePos = mLrcStr.indexOf("n", mNextPos); 


j 
startAnimation(-mLineHeight*i, 100); 


(a Override 
public void onMusicPause() í 
animTranY.pause(); 


(a Override 
public void onMusicResume() í 
animTranY.resume(); 


// 音 量 调节 对 话 框 
@Override 
public boolean onKeyDown(int keyCode, KeyEvent event) { 

if (keyCode = KeyEvent.KEYCODE_VOLUME UP) í 
show VolumeDialog(AudioManager.ADJUST_RAISE); 
return true; 

} else if (keyCode = KeyEvent.KEYCODE VOLUME DOWN) í 
showVolumeDialog(AudioManager.ADJUST LOWER); 
return true; 

} else if (keyCode = KeyEvent.KEYCODE BACK) í 
finish(); 

; 

return false; 
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private void showVolumeDialog(int direction) í 
if (dialog—null || dialog.isShowing()!=true) { 
dialog = new VolumeDialog(this); 
dialog.setVolumeA djustListener(this); 
dialog.show(); 
p 
dialog.adjustVolume(direction, true); 
onVolumeAdjust(mAudioMgr.getStreamVolume(AudioManager.STREAM MUSIC)); 
1 


@Override 
public void onVolumeAdjust(int volume) { 
} 
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本 章 主要 介绍 App 开发 用 到 的 常见 多 媒体 技术 ， 包 括 自 定义 相册 的 实现 (画廊 、 图 像 切 
换 器 、 卡 片 视图 、 调 色 板 ) 、 影 视 播放 器 的 实现 〈 视 频 视 图 、 媒 体 控制 条 、 阶 段 实战 项 目 “ 爱 
看 剧场 ”) ~ ContentProvider 内 容 组 件 的 用 法 《内容 提 供 器 、 内 容 解 析 器 、 内 容 操 作 器 、 内 容 
观察 器 ) 。 最 后 设计 了 一 个 实战 项 目 “ 音 乐 播放 器 一 一 浪花 音乐 ”， 在 该 项 目的 App 编码 中 
采用 了 本 书 到 目前 为 止 的 主要 技术 点 , 实现 了 歌曲 的 播放 控制 和 歌词 的 滚动 显示 。 另外, 介绍 
了 可 变 字 符 串 的 种 类 及 其 使 用 说 明 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 5 种 开发 技能 : 

(1) 学 会 如 何 使 用 图 像 控 件 实现 自 定义 相册 。 

(2) 学 会 如 何 使 用 视频 控件 实现 影视 播放 器 。 

(3) 学 会 如 何 使 用 音频 控件 实现 音乐 播放 器 。 

(4) 学 会 ContentProvider 组 件 的 用 法 ， 如 封装 数据 的 对 外 接口 ， 对 开放 内 容 接 口 的 系统 
数据 进行 查询 、 修 改 和 监视 操作 。 

(5) 学 会 借助 可 变 字符 串 在 一 段 文 本 中 运用 不 同 的 风格 样式 。 





CEPS 融合 技术 


本 章 介绍 融合 技术 的 几 个 方向 , 主要 包括 使 用 网 页 集成 
技术 实现 不 同 终端 显示 同一 个 网 页 、 使 用 JNI 开发 技术 实现 
不 同 平台 运行 同一 套 代 码 、 使 用 局 域 网 共享 技术 实现 不 同 设 
备 分 享 同一 份 文件 。 最 后 结合 本 章 所 学 的 知识 演示 一 个 实战 
项 目 “WIFI 共享 器 ”的 设计 与 实现 。 
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14.1 网 页 集成 


本 节 介 绍 融 合 技术 的 一 个 重要 方向 一 一 网 页 集成 ，Web 页 面 可 以 直接 在 Android. iOS. 
Windows 等 终端 上 显示 ， 能 够 减少 重复 的 适 配 工 作 ， 有 效 降低 开发 成 本 。 本 节 首 先 说 明 如 何 
使 用 资产 管理 器 打开 文本 文件 、 图 片 文件 以 及 加 载 网 页 ， 接 着 逐步 阐述 网 页 视图 的 详细 用 法 ， 
最 后 利用 网 页 视图 实现 一 个 简单 浏览 器 。 


14.1.1 资产 管理 器 AssetManager 


如 同 所 有 的 应 用 程序 那样 , App 运行 时 也 要 读 取 事先 定义 好 的 配置 信息 , 并 加 载 图 片 等 资 
源 文件 。 一 般 情况 下 ， 这 些 配 置信 息 与 资源 文件 可 以 放 在 工程 的 res 目录 中 ， 举 例如 下 : 


(1) 图 片 文件 与 图 形 定义 文件 可 以 放 在 res/drawable 目录 。 
(2) 字符 串 定义 可 以 放 在 res/values/strings.xml 文件 中 。 
(3) 颜色 值 定义 可 以 放 在 res/values/colors.xml 文件 中 。 
(4) 整 型 数 定义 可 以 放 在 res/values/integers.xml 文件 中 。 
(5) 各 类 数组 定义 可 以 放 在 res/values/arrays.xml 文件 中 。 
(6) 音频 等 其 他 二 进 制 流 文件 可 以 放 在 res/raw 目录 。 
乍 看 之 下 ，res 目录 已 经 允许 保存 几乎 所 有 配置 信息 与 资源 文件 了 ， 不 过 事情 往往 存在 各 
种 预料 之 外 的 情况 ， 比 如 以 下 业务 场景 就 无 法 使 用 res 配置 : 
(1) 大 批量 的 初始 化 数据 ， 需 要 在 App 第 一 次 安装 时 导入 数据 库 。 因 为 res/values 目录 
下 放 的 是 键 值 对 数据 (如 key-value) ， 难 以 转换 为 数据 库 中 存储 的 关系 型 数据 。 
(2) 工程 源码 要 导出 为 JAR f, 作为 一 个 SDK 给 其 他 工程 使 用 。 因 为 res 目录 无 法 集成 
到 jar 包 中 ， 所 以 待 集成 的 图 片 资源 不 可 放 在 res 目录 。 
G) 如 网 页 HTML 这 种 需要 保持 原 有 格式 的 文件 ， 不 适合 放 在 res 目录 中 进行 编译 。 
基于 此 ，Android 提供 了 一 个 assets 目录 用 来 保存 以 上 特殊 需求 的 文件 。 在 Android Studio 
中 创建 一 个 新 模块 ， 默 认 没 有 assets 目录 ， 开 发 者 得 自己 在 src/main 目录 下 新 建 assets 目录 ， 
然后 在 该 目录 中 存放 各 种 要 求 保持 原 有 格式 的 文件 。 
因为 assets 目录 下 的 资产 文件 不 会 被 系统 编译 ， 所 以 无 法 通过 R.*.* 这 种 方式 访问 ， 需 要 
使 用 另外 的 工具 一 一 资产 管理 器 AssetManager 访问 。 通 过 该 工具 ， 我 们 能 够 以 输入 流 方式 打 
开 assets 目录 的 文件 ， 并 将 输入 流转 换 为 文本 或 图 像 。 
在 Activity 代码 中 调用 getAssets 方法 可 获得 AssetManager 对 象 。 下 面 是 AssetManager 的 
常用 方法 说 明 。 
e list: 列 出 指定 目录 下 的 文件 与 文件 夹 列表 数组 。 
e open: 打开 资产 文件 ， 返 回 输入 流 InputStream 对 象 。 访 问 模式 默认 是 AssetManager. 
ACCESS_STREAMING， 表 示 流 式 访问 ， 即 顺序 读 取 。 
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e close: 关闭 资产 管理 器 。 
assets 目录 保存 的 多 是 文本 文件 与 图 片 文件 。 使 用 AssetManager 读 取 文 本 和 图 像 的 代码 如 下 : 


public static String getTxtFromAssets(Context context, String fileName) í 
String result = "": 
try { 
InputStream is = context.getAssets().open(fileName); 
int lenght = is.available(); 
byte[] buffer = new byte[lenght]; 
is.read(buffer); 
result = new String(buffer, "utf8"); 
} catch (Exception e) í 
e.printStackTrace(); 
} 
return result; 


j 


public static Bitmap getImgFromAssets(Context context, String fileName) { 
Bitmap bitmap = null; 
try ( 
InputStream is = context.getAssets().open(fileName); 
bitmap — BitmapFactory.decodeStream(is); 
} catch (Exception e) í 
e.printStackTrace(); 
J 
return bitmap; 


j 


资产 管理 器 读 取 文本 与 图 像 的 效果 如 图 14-1 和 图 14-2 所 示 。 其 中 ,图 14-1 所 示 为 从 assets 
目录 读 取 并 显示 文本 文件 的 画面 ， 图 14-2 所 示 为 从 assets 目录 读 取 并 显示 图 片 文件 的 画面 。 





下 面 文字 来 源 于 资产 文件 file/libaitxt 下 面 图 像 来 源 于 资产 文件 file/waterjpg 
ETT I 7 X 
zB 

DREPER 


飞 流 直 下 三 千 尺 ， 
疑 是 银河 落 九 天 。 














图 14-1 从 资产 目录 读 取 文本 图 14.2 ”从 资产 目录 读 取 图 片 
14.1.2 ”网 页 视图 WebView 


前 面 提 到 assets 目录 可 保存 网 页 文件 ， 由 于 网 页 不 是 一 般 的 文本 文件 ， 而 是 包含 一 系列 
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html 标签 的 页 面 描 述 定义 ， 因 此 如 果 想 显示 网 页 的 效果 画面 而 非 源 代码 ， 就 得 借助 于 网 页 视 
图 WebView。WebView 相当 于 Android 的 一 个 浏览 嚣 内核， 可 内 嵌 并 展示 Web 页 面 ， 并 处 理 
App 与 Web 的 交互 操作 。 
调用 WebView 对 象 的 loadUrl 方法 可 让 网 页 视图 显示 资产 目录 中 的 网 页 ， 注 意 要 在 网 页 
路 径 前 加 上 file:///android_asset/， 表 示 该 网 页 来 自 于 本 地 的 assets 目录 ， 具 体 代码 如 下 : 
public class WebLocalActivity extends AppCompatActivity { 
private String mFilePath = "file:///android_asset/html/index.html"; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 


} 


WebView 展示 本 地 网 页 的 效果 如 图 14-3 所 示 。 页 面 
左边 是 图 片 ， 右 边 是 诗歌 的 文本 。 

网 页 视图 可 以 访问 本 地 网 页 ,也 可 以 访问 外 部 网 页 。 [denm 
在 电脑 浏览 器 上 查看 网 页 时 经 常 通过 点 击 超 链接 打开 新 ; 
窗口 。 在 手机 上 ，App 要 实现 超 链 接 跳 转 ， 可 参照 第 13 
章 的 可 变 字符 串 UrlSpan, 该 风格 把 指定 位 置 的 文字 转 为 
超 链接 ， 点 击 超 链接 文字 即 可 跳 转 到 相应 URL。 注 意 这 
里 的 跳 转 URL 其 实 是 在 一 个 网 页 视图 中 打开 的 。 

看 来 App 针对 超 链接 的 处 理 比 HTML 复杂 , 虽然 复 
杂 了 点 ， 但 是 


super.onCreate(savedInstanceState); 
setContentView(R.layout.activity web local); 

TextView tv web path = (TextView) find ViewById(R.id.tv web path); 
WebView wv assets web = (WebView) find ViewById(R.id.wv assets web); 
tv_web_path.setText(" 下 面 网 页 来 源 于 资产 文件 "+tmFilePath); 

wv assets web.loadUrl(mFilePath); 

wv assets web.setWebViewClient(new WebViewClient()); 


下 面 网 页 来 源 于 资产 文件 fle:///android_asset/html/ 


ELT Lg 
李白 











套用 固定 的 代码 模板 使 用 也 不 难 。 使 用 超 





链接 风格 打开 网 页 视图 的 代码 如 下 : H3 从 资产 目录 读 取 网 页 
private void showUrlSpan() í 


EXCLUSIVE); 


SpannableString spanText — new SpannableString(mText); 

/调用 setMovementMethod 方法 设置 LinkMovementMethod 后 ， 点 击 超 链 接 才 有 反应 

tv spannable.setMovementMethod(LinkMovementMethod.getInstance()); 

Spannable sp = (Spannable) Html.fromHtml("-a href=\"\">"+mKey+"</a>"); 

CharSequence text — sp.toString(); 

URLSpan([] urls = sp.getSpans(0, text.length(), URLSpan.class); 

for (URLSpan url : urls) í 
MyURLSpan myURLSpan = new MyURLSpan(url.getURL()); 
spanText.setSpan(myURLSpan, mBeginPos, mEndPos, Spanned.SPAN EXCLUSIVE __ 
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tv_spannable.setText(spanText); 
$ 


private class MyURLSpan extends URLSpan í 

public MyURLSpan(String url) í 
super(url); 

Ü 

(@Override 

public void onClick(View widget) í 
wv. spannable.setVisibility(View. VISIBLE); 
wv spannable.loadUrl("http://blog.csdn.net/aqi00"); 
wv spannable.requestFocus(); 
wv spannable.setWebViewClient(new WebViewClient()); 
return; 


1 


超 链接 风格 的 文字 效果 如 图 14-4 所 示 。 文 字 加 
了 下 划 线 ， 并 且 文 字 与 下 划 线 都 高 亮 显示 。 点 击 超 sme. dit 
链接 后 ， 在 网 页 视图 中 打开 指定 的 URL 地 址 ， 显 aiies 
示 的 Web 页 面 如 图 14-5 所 示 ， 看 起 来 是 手机 版 的 。 | sp 
网 页 。 "pem 
eo 


113502 1251 125 209 





博文 分 类 专栏 








Android 开 发 笔记 (OF) 写 在 前 面 的 目录 








SISTI PREX 超 链接 
打开 Android Studio 报 销 "required plugin 
为 人 民 服 务 "Android Support" is disabled" 
图 144 超 链 风格 的 文字 效果 图 14-5 点 击 超 链接 打开 网 页 


14.1.3 ”简单 浏览 器 
注意 前 面 使 用 的 WebView, 除了 调用 loadUrl 方法 外 , 还 调用 了 其 他 方法 (如 setWebViewClient 

等 ) 。 下 面 说 明 WebView 的 常用 方法 。 
e loadUrl: 加 载 指定 的 URL, URL 可 以 是 http 打头 的 外 部 网 址 ， 也 可 以 是 file 打头 的 资产 
网 页 。 


e getSetings: 获取 浏览 器 的 网 页 设置 信息 。 返 回 一 个 网 页 设置 WebSettings 对 象 。 
e addJavascriptInterface: 添加 供 JavaScript 调用 的 App 接口 。 
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setWebViewClient: 设置 网 页 视图 的 客户 端 对 象 WebViewClient， 如 果 已 调用 loadUrl 77 
法 ， 就 必须 同时 调用 本 方法 。 

setWebChromeClient: 设置 浏览 器 的 网 页 交互 客户 端 WebChromeClient。 
setDownloadListener: 设置 文件 下 载 监听 器 DownloadListener。 

loadData: 加 载 文本 数据 。 第 二 个 参数 表示 媒体 类 型 ， 如 text/html; 第 三 个 参数 表示 数据 
的 编码 格式 ， 如 base64 表示 采用 BASE64 编码 ， 其 余 值 (包括 null) 表示 URL 编码 。 
canGoBack: 判断 页 面 能 否 返回 。 

goBack: 返回 上 一 个 页 面 。 

canGoForward: 判断 页 面 能 否 前 进 。 

goForward: 前 进 到 下 一 个 页 面 。 

reload: 重新 加 载 页 面 。 

stopLoading: 停止 加 载 页 面 。 


上 述 方法 中 有 4 个 组 件 需要 补充 描述 ， 包 括 网 页 设置 WebSettings、 网 页 视图 客户 端 
WebViewClient、 网 页 交互 客户 端 WebChromeClient 和 文件 下 载 监听 器 DownloadListener。 


1. 网 页 设置 WebSettings 

WebSettings 用 于 管理 网 页 视图 的 加 载 属性 , 指明 了 什么 该 做 、 什么 不 该 做 。 调 用 WebView 
对 象 的 getSettings 方法 即 可 获得 WebSettings 对 象 。 下 面 是 WebSettings 的 常用 设置 方法 。 

以 下 是 基本 的 加 载 设置 。 


setLoadsImagesAutomatically: 设置 是 否 自动 加 载 图 片 。 如 果 设 置 为 false, 就 表示 无 图 模式 。 
setDefaultTextEncodingName: 设置 默认 的 文本 编码 ， 如 UTF-8. GBK 等 。 
setJavaScriptEnabled: 设置 是 否 支持 JavaScript. 
setJavaScriptCanOpenWindowsAutomatically: 设置 是 否 允 许 JavaScript 自动 打开 新 窗口 ， 
即 JS 的 window.open 方法 是 否 适用 。 


以 下 是 与 网 页 适 配 有 关 的 设置 。 


setSupportZoom: 设置 是 否 支持 页 面 缩放 。 

setBuiltInZoomControls: 设置 是 否 出 现 缩放 工具 。 

setUseWideViewPort: 当 容 器 超过 页 面 大 小 时 ， 是 否 将 页 面 放 大 到 塞 满 容器 宽度 的 尺寸 。 
setLoadWithOverviewMode: 当 页 面 超 过 容器 大 小 时 ， 是 否 将 页 面 缩小 到 容器 能 够 装 下 的 
尺寸 。 

setLayoutAlgorithm: 设置 自 适 应 屏幕 的 算法 ， 一 般 是 LayoutAlgorithm.SINGLE COLUMN. 
如 果 不 设置 ，Android4.2.2 及 之 前 的 版 本 就 可 能 出 现 表格 错乱 的 情况 。 


以 下 是 与 存储 有 关 的 设置 。 


setAppCacheEnabled: 设置 是 否 启用 App 缓存 。 
setAppCachePath: 设置 App 缓存 文件 的 路 径 。 
setAllowFileAccess: 设置 是 否 允 许 访问 文件 ， 如 WebView 访问 SD 卡 的 文件 。 


* 543 * 
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e setDatabaseEnabled: 设置 是 否 启用 数据 库 。 
e setDomStorageEnabled: 设置 是 否 启用 本 地 存储 。 
e setCacheMode: 设置 使 用 的 缓存 模式 。 缓 存 模式 的 取 值 说 明 见 表 14-1. 


表 14-1 缓存 模式 的 取 值 说 明 
说 明 

优先 使 用 缓存 
不 使 用 缓存 
只 使 用 缓存 


WebSettings 类 的 缓存 模式 

LOAD CACHE ELSE NETWORK 
LOAD NO CACHE 

LOAD CACHE ONLY 














2. 网 页 视图 客户 端 WebViewClient 


可 以 将 WebViewClient 看 作 网 页 加 载 监 听 器 , 用 于 处 理 与 加 载 动作 有 关 的 事件 , WebView 
对 象 调 用 setWebViewClient 方法 即 可 设置 客户 端 。 需 要 重 写 以 下 方法 说 明 。 
onPageStarted: 页 面 开始 加 载 时 触发 。 可 在 此 弹出 进度 对 话 框 ProgressFialog。 
onPageFinished: 页 面 加 载 结束 时 触发 。 可 在 此 关闭 进度 对 话 框 。 
onReceivedEmor: 收 到 错误 信息 时 触发 。 
onReceivedSslError: 收 到 SSL 错误 时 触发 。 
shouldOverrideUrlLoading: 重 写 该 方法 的 目的 是 判断 每 当 点 击 网 页 里 中 链接 时 ， 是 想 在 
当前 的 网 页 视图 里 跳 转 还 是 跳 转 到 系统 自 带 的 浏览 器 。 
在 当前 的 网 页 视图 内 部 跳 转 ， 重 写 方法 代码 如 下 : 
public boolean shouldOverrideUrlLoading( WebView view, String url) í 
view.loadUrl(url); 
return true; 


li 
3. 网 页 交互 客户 端 WebChromeClient 


WebChromeClient 用 于 处 理 网 页 与 App 之 间 的 交互 事件 ，WebView 对 象 调用 
setWebChromeClient 方法 即 可 设置 客户 端 。WebChromeClient 需要 重 写 的 方法 说 明 如 下 : 


onReceivedTitle: 收 到 页 面 标题 时 触发 。 
onProgressChanged: 页 面 加 载 进 度 发 生变 化 时 触发 。 可 在 此 刷新 进度 对 话 框 的 进度 条 。 
onJsAlert: 网 页 的 JS 代码 调用 alert 方法 时 触发 。 可 在 此 弹出 自 定义 的 提示 对 话 框 。 
onJsConfirm: 网 页 的 JS 代码 调用 confirm 方法 时 触发 . 可 在 此 弹出 自 定义 的 确认 对 话 框 。 
onJsPrompt: 网 页 的 JS 代码 调用 prompt 方 法 时 触发 。 可 在 此 弹出 自 定义 的 提示 对 话 框 。 
onGeolocationPermissionsShowPrompt: 网 页 请 求 定位 权限 时 触发 。 可 在 此 弹出 一 个 确认 
对 话 框 , 提示 用 户 是 否 允 许 网 页 获得 定位 权限 。 如 果 不 想 出 现 弹 窗 就 允许 网 页 获得 权限 ， 
重 写 方 法 代码 如 下 : 
public void onGeolocationPermissionsShowPrompt(String origin, Callback callback) { 
callback.invoke(origin, true, false); 
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super.onGeolocationPermissionsShowPrompt(origin, callback); 
; 


4. 文件 下 载 监 听 器 DownloadListener 
DownloadListener 用 于 监听 网 页 的 下 载 事 件 ，WebView 对 象 调用 setDownloadListener 方 
法 即 可 设置 下 载 监听 器 。DownloadListener 只 有 onDownloadStart 方法 需要 重 写 。 
e onDownloadStart: 文件 开始 下 载 触发 。 可 在 此 接管 下 载 动作 ， 比 如 设置 文件 下 载 的 方式 、 
文件 的 保存 路 径 等 。 
了 解 网 页 视图 相关 组 件 的 具体 用 法 后 ， 接 下 来 让 我 们 实现 一 个 简单 的 浏览 器 ， 进 一 步 加 
深 对 WebView 运用 的 理解 。 下 面 是 使 用 WebView 实现 简单 浏览 器 的 代码 : 


public class WebBrowserActivity extends AppCompatActivity implements OnClickListener í 
private final static String TAG = "WebBrowserActivity":; 
private EditText et web url; 





private WebView wv web; 
private ProgressDialog m. pd; 


(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity web browser); 
et web url = (EditText) findViewById(R.id.et web url); 
et web url.setText("news.qq.com/"); 
wv. web = (WebView) findViewById(R.id.wv web); 
findViewById(R.id.btn web go).setOnClickListener(this); 
findViewByld(R.id.ib back).setOnClickListener(this); 
findViewByld(R.id.ib forward).setOnClickListener(this); 
findViewByld(R.id.ib refresh).setOnClickListener(this); 
findViewByld(R.id.ib close).setOnClickListener(this); 
initWebViewSettings(); 


(a SuppressLint("SetJavaScriptEnabled") 

private void initWebViewSettings() í 
WebSettings settings = wv web.getSettings(); 
settings.setLoadsImagesAutomatically(true); 
settings.setDefaultTextEncodingName("utf-8"); 
settings.setJavaScriptEnabled(true); 
settings.setJavaScriptCanOpenWindowsAutomatically(false); 
settings.setSupportZoom(true); 
settings.setBuiltInZoomControls(true); 
settings.setUseWideViewPort(true); 
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settings.setLoadWithOverviewMode(true); 
settings.setLayoutAlgorithm(LayoutAlgorithm.SINGLE COLUMN); 


(@Override 
public void onClick(View v) í 
if (v.getId() = R.id.btn web go) í 
InputMethodManager imm = (InputMethodManager) getSystemService(Context.INPUT _ 
METHOD SERVICE); 
imm.hideSoftInputFromWindow(et web url.getWindowToken(), 0); 
String url = "http://" + et web url.getText().toString(); 
Log.d(TAG, "url-"-url); 
wv. web.loadUrl(url); 
wv. web.setWebViewClient(mWebViewClient); 
wv. web.setWebChromeClient(mWebChrome); 
wv. web.setDownloadListener(mDownloadListener); 
} else if (v.getId() = R.id.ib back) í 
if(wv web.canGoBack()) í 
wv. web.goBack(); 
} else { 
Toast.makeText(this, "已 经 是 最 后 一 页 了 ", Toast. LENGTH_SHORT).show(); 
] 
} else if (v.getld() = R.id.ib forward) í 
if(wv web.canGoForward()) í 
wv web.goForward(); 
} else ( 
Toast.makeText(this, "已 经 是 最 前 一 页 了 ", Toast. LENGTH. SHORT ).show(); 
j 
} else if (v.getId() = R.id.ib refresh) í 
// 重 新 加 载 。 停 止 加 载 用 stopLoading 


wv. web.reload(); 
) else if (v.getId() = R.id.ib close) í 
finish(); 
; 
k: 
@Override 


public void onBackPressed() { 
if (wv_web.canGoBack()) { 
wv_web.goBack(); 
return; 
}else{ 
finish(); 








融合 技术 第 14 BE 





private WebViewClient mWebViewClient =new WebViewClient() í 
@Override 
public void onReceivedSslError(WebView view, android.webkit.SslErrorHandler handler, 
android.net.http.SslError error) { 
handler.proceed(); 
h 


@Override 
public void onPageStarted(WebView view, String url, Bitmap favicon) { 
super.onPageStarted(view, url, favicon); 
Log.d(TAG, "onPageStarted:" + url); 
if(m pd = null || m pd.isShowing() — false) í 
m pd- new ProgressDialog( WebBrowserActivity.this); 
m pd.setTitle(" fj^"); 


m_pd.setMessage(" 页 面 加 载 中 ……"); 
m pd.setProgressStyle(ProgressDialog.STYLE HORIZONTAL); 
m pd.show(); 
} 
@Override 


public void onPageFinished(WebView view, String url) { 
super.onPageFinished(view, url); 
Log.d(TAG, "onPageFinished:" + url); 
if(m pd != null && m pd.isShowing() == true) í 
m pd.dismiss(); 


@Override 
public void onReceivedError( WebView view, int errorCode, String description, String failingUrl) í 
super.onReceivedError(view, errorCode, description, failingUrl); 
Log.d(TAG, "onReceivedError: url=" + failingUrl+", errorCode="+errorCode+", 
description-"--description); 
if(m pd != null && m pd.isShowing() — true) í 
m pd.dismiss(); 
} 
Toast.makeText(WebBrowserActivity.this, "页 面 加 载 失败 ， 请 稍 候 再 试 "， 
Toast.LENGTH_LONG).show(); 


} 
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(@Override 

public boolean shouldOverrideUrILoading( WebView view, String url) í 
view.loadUrl(url); 
return true; 


h 


private WebChromeClient mnWebChrome = new WebChromecClient() í 
@Override 
public void onProgressChanged(WebView view, int progress) { 
if(m pd != null && m pd.isShowing() == true) í 
m pd.setProgress(progress); 
5 
J 


@Override 

public void onGeolocationPermissionsShowPrompt(String origin, Callback callback) { 
callback.invoke(origin, true, false); 
super.onGeolocationPermissionsShowPrompt(origin, callback); 


h 


private DownloadListener mDownloadListener = new DownloadListener() í 
@Override 
public void onDownloadStart(String url, String userAgent, String contentDisposition, 
String mimetype, long contentLength) { 
// 此 处 操作 文件 下 载 


} 


简单 浏览 器 的 展示 效果 如 图 14-6 一 图 14-9 Bros. 其中, 图 14-6 所 示 为 打开 浏览 器 的 初始 
页 面 ， 页 面 上 部 为 地 址 栏 ， 下 部 为 控制 栏 ( 从 左 到 右 依次 是 前 进 、 后 退 、 刷 新 、 退 出 等 按钮 ) ， 
在 地 址 栏 输入 网 址 并 点 击 “ 快 去 ”按钮 ， 浏 览 器 显示 正在 加 载 的 进度 对 话 框 ， 如 图 14-7 所 示 ; 
网 页 加 载 完毕 后 , 进度 对 话 框 消失 , 浏览 器 主 视 图 中 显示 该 网 址 的 Web 页 面 , 如 图 14-8 Bros: 
点 击 该 页 面 的 第 一 条 新 闻 ， 浏 览 器 打开 该 新 闻 的 详情 页 面 ， 如 图 14-9 所 示 。 

要 想 在 前 后 网 页 中 切换 ， 可 点 击 下 方 控制 栏 的 前 进 或 后 退 按钮 ， 要 想 重 新 加 载 当前 网 页 ， 
可 点 击 控制 栏 的 刷新 按钮 ， 要 想 退 出 浏览 器 ， 可 点 击 控制 栏 右边 的 退出 按钮 。 读 者 若 有 兴趣 ， 
也 可 加 入 其 他 高 级 功能 ， 如 设置 默认 主页 、 开 局 无 图 模式 、 添 加 书签 管理 等 内 容 。 
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[httpJ/ news. qq.com/ 


http:// news.qq.com/ 快 去 





4 2 
图 14-6 浏览 器 的 初始 界面 图 14-7 浏览 器 加 载 网 页 中 


http:// news.qq con 
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图 14-8. 浏览 器 加 载 网 页 完成 图 14-9 点 击 进入 焦点 新 闻 


14.2 JNI 开发 


本 节 介绍 融合 技术 的 一 个 重要 方向 JNI 开 发 。C/C++ 语 言 具 有 跨 平台 特性 ， 苹 果 操 作 
系统 能 够 直接 运行 C/C++ 代码 ， 如 果 功 能 采用 C/C++ 实 现 ， 就 很 容易 在 不 同 平台 (如 Android 
与 iOS) 之 间 移 植 。 本 节 首 先 说 明 如 何在 Android Studio 中 搭建 NDK 编译 环境 ;接着 阐述 如 
何 使 用 JNI 接口 完成 Java 代码 对 C 代码 的 调用 ; 最 后 描述 JNI 技术 适用 的 业务 场景 ， 并 给 出 
一 个 实际 需求 的 应 用 项 目 “JNI 实现 加 解密 ”。 
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14.2.1 NDK 环境 搭建 


完整 的 Android Studio 环境 包括 3 个 开发 工具 ， 即 JDK. SDK 和 NDK， 早 在 第 一 章 就 对 
这 些 工具 做 了 介绍 ， 这 里 不 妨 复习 一 下 。 


(1) JDK 是 Java 语 言 的 编译 器 ， 因 为 App 采 用 Java 语 言 开发 ， 所 以 开发 机 上 要 先 安装 JDK。 

(2) SDK 是 Android 应 用 的 编译 器 ， 提 供 了 Android 内 核 的 公共 API 调用 ， 所 以 开发 
App 必须 安装 SDK. 

G) NDK 是 C/C++ 代码 的 编译 器 ， 如 果 App 未 使 用 JNI 技术 ， 就 无 须 安装 NDK; 如 果 
App 用 到 JNI， 就 必须 安装 NDK. 


NDK 允许 开发 者 在 App 中 通过 C/C++ 代码 执行 部 分 操作 , 然后 由 Java 代码 通过 JNI 接口 
调用 C/C++ 代码 。 既 然 本 节 讲 的 是 JNI 开发 ， 那 么 肯定 要 给 Android Studio 安装 NDK. 

下 面 是 NDK 环境 的 搭建 步骤 说 明 。 

ED) 到 谷歌 开发 者 网 站 下 载 最 新 的 NK 开发 包 ， 下 载 页 面 地 址 是 
https://developer.android.google.cn/ndk/downloads/index.html。 下 载 完毕 后 ， 解 压 到 本 地 路 径 ， 比 如 笔者 
把 NDK 解压 到 了 D:\android-ndk-r13b。 注 意 目录 名 称 不 要 有 中 文 。 

E 在 系统 中 增加 NDK 的 环境 变量 定义 ， 如 变量 名 为 NDK_ROOT， 变 量 值 为 
Di\android-ndk-r13b。 另 外 ， 在 Path 变量 值 后 面 补充 :%NDK_ROOT%。 

EI 在 项 目 名 称 上 右 击 , 然后 在 弹出 的 菜单 项 — 


t Eetactor , 
gnetwork 























中 选择 Open Module Settings, 打开 设置 页 面 , 如 图 14-10 [NAM c ed 
eee s lla 
所 示 。 也 可 依次 选择 菜单 File—Project Structure 打开 设 让 bte pet ena 
置 页 面 。 T re cen 
在 打开 的 设置 页 面 中 依次 找到 SDK Location 一 so cradle M Run KL Teste! vith Coverage 
NDK Location， 设 置 前 面 解压 的 NDK 目录 路 径 ， 然 后 edd 
单 击 OK 按钮 ， 设 置 页 面 如 图 14-11 所 示 。 m o 
CIJ04 在 模块 的 src/main 路 径 下 创建 名 为 jni fy |S aree ned 
目录 , h 文件 、 c 文件 、 cpp 文件 、 mk 编译 文件 都 放 在 Puo dj Andrei Open Module Settings n 
|| Gradis build finish @ Create Gist... 
该 目录 下 。 jni 目录 的 结构 如 图 14-12 所 示 , 可 以 看 到 jni 
与 java、res 等 目录 平 级 。 图 14-10 设置 页 面 

















14-11 “项目 结构 页 面 设置 NDK 的 安装 路 径 14-12. jni 目录 在 模块 工程 中 的 位 置 


* 550 。 
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EI 打开 模块 的 编译 配置 文件 build.gradle， 在 defaultConfig 节点 内 补充 如 下 编译 配置 : 
ndk { 


moduleName "jni mix" 
cFlags "-fexceptions" 
IdLibs "log", "z", "m" 
stl "stlport static" 
abiFilters "armeabi", "armeabi-v7a", "x86" 
n 
在 Android Studio 22 及 之 后 版 本 中 ， 也 可 直接 在 android 节点 下 补充 mk 文件 路 径 ， 表 示 采 用 外 
部 文件 的 编译 规则 ， 配 置 说 明 举 例如 下 : 

















externalNativeBuild { 
ndkBuild í 
path file("sre\main\jni\Android.mk") 
] 
ji 


Eoo 打开 项 目的 gradle.properties， 增 加 一 行 配置 android.useDeprecatedNdk=true。 

CX307 依次 选择 菜单 Build 一 Rebuild Project， 或 选择 Build 一 Make Module ***， 执 行 C/C++ 代 
码 的 编译 工作 。 编 译 通 过 后 ， 可 在 “模块 名 称 \build\intermediates\ndk\debug\lib” 路 径 下 找到 生成 的 so 
库 文件 ，so 文件 的 完整 路 径 结构 如 图 14-13 所 示 。 

CX08 t src/main 路 径 下 创建 so 库 的 保存 目录 ， 目 录 名 称 为 jniLibs， 并 将 生成 的 so 文件 复制 
到 该 目录 下 。 复 制 完 so 库 的 目录 结构 如 图 14-14 所 示 ， 可 见 jniLibs 5 jni 目录 平 级 。 
v Daizture 

v 门 build 


> 门 generated 
Y internediates 

















> assets 
> Dolare 
> Cabundles 
> classes 
» D dependency-cache 
> Dexploded-aar > Dbuild 
> O increnental O libs 
> D increnental-safeguard v Dsre 
> D instant-runsupport b DandroidTest 
> DjniLibs Y Dnain 
> Daanifest » Caassets 
> aanifests > Eli 
Y Drk 2 
Y VIE v D jniLibs 


Y arneabi 
[) libjni_aiz.so 
Y D araeabi-v7a 
回 1ibjni mix.so 
> 站 obj 
El Android. nk 





14-13 编译 生成 的 so 文件 的 路 径 
€» 


8 





v 站 arneabi 

加 1ibjni mix.so 
Y [araeabi-v7a 

回 libjni_nix. so 
Dares 


Eš AndroidKanifest.xal 


Y 








14-14. jniLibs 目录 在 模块 工程 中 的 位 置 


看 新 运行 App 或 重新 生成 签名 Apk， 最 后 产生 的 App 就 是 封装 好 so 库 版 本 。 
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14.2.2 ”创建 JNI 接口 


JNI 是 Java Native Interface 的 缩写 ， 提 供 了 若干 API SKI Java 和 其 他 语言 的 通信 〈 主 要 
是 C/C++) 。 虽 然 JNI 是 Java 平台 的 标准 ， 但 是 要 想 在 Android 上 使 用 JNI， 还 得 配合 NDK 
才 行 .NDK 提供 了 C/C++ 标准 库 的 头 文件 和 标准 库 的 动态 链接 文件 (主要 是 .a 文件 和 .so 文件 )。 
而 INI 开发 只 是 在 App 工程 下 编写 C/C++ 代码 ， 代 码 中 包含 NDK 提供 的 头 文件 ，build.gradle 
或 mk 文件 依据 编译 规则 把 标准 库 链 接 进去 ， 编 译 通 过 后 形成 最 终 的 so 动态 库 文件 ， 这 样 才 
能 在 App 中 通过 Java 代码 调用 JNI 接口 。 

下 面 是 JNI 开发 的 具体 步骤 。 


C0) 确保 NDK 环境 搭建 完成 ， 并 且 本 模块 已 经 添加 了 对 NDK 的 支持 。 
E 在 要 调用 JNI 接口 的 Activity 代码 中 添加 JNI 接口 定义 ,并 在 初始 化 时 加 载 JNI 动态 库 ， 
具体 代码 举例 如 下 : 
public native String cpuFromJNI(int il, float f1, double d1, boolean b1); 
public native String unimplementedCpuFromJNl(int il, float f1, double d1, boolean b1); 
static í 
System.loadLibrary("jni mix"); 




















} 

E 转 到 工程 的 jni 目录 下 ， 在 h 文件、c 文件 、cpp 文件 中 编写 C/C++ 代码 。 注 意 C 代码 
中 对 接口 名 称 的 命名 规则 是 “Java 包 名 _Activity 类 名 函数 名 ”。 其 中 , 包 名 中 的 点 号 要 替换 为 下 划 线 。 
下 面 是 C 代码 对 接口 名 称 命名 的 代码 : 

jstring Java com example mixture JniCpuActivity cpuFromJNI( JNIEnv* env, jobject thiz, jint i1, jfloat f1, 
jdouble d1, jboolean b1 ) 

ED 在 build.gradle 中 编写 本 模块 的 NDK 编译 规则 ， 或 另外 在 jni 目录 创建 一 个 mk 文件 单 
独 定义 编译 规则 (如 果 在 build.gradle 中 启用 了 externalNativeBuild 节点 ) 。 

编译 JNI 代 码 ， 并 把 编译 生成 的 so 库 复 制 到 jniLibs 目录 ， 再 重新 运行 App。 

以 上 开发 步骤 尚 有 3 处 需要 补充 描述 ， 分 别 是 数据 类 型 转换 、 编 译 规则 定义 以 及 开发 注 
意 事项 ， 详 细 说 明 如 下 : 


1. 数据 类 型 转换 














JNI 作为 Java 与 C/C++ 之 间 的 联系 桥梁 , 需要 对 基本 数据 类 型 进行 转换 , 基本 数据 类 型 的 
转换 关系 见 表 14-2。 


表 14-2 基本 数据 类 型 的 转换 关系 
Java 的 数据 类 型 


int 














| float 
double 


浮 点 数 








double 
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( 续 表 ) 
数据 类 型 名 称 Java 的 数据 类 型 JNI 的 数据 类 型 C/C++ 的 数据 类 型 
布尔 型 boolean jboolean unsigned char 
字符 串 String jstring const char* 





其 中 ， 整 型 、 浮 点 数 、 双 精度 3 种 数据 类 型 可 以 由 C/C++ 直 接 使 用 ， 而 布尔 型 和 字符 串 
需要 处 理 后 才能 由 C/C++ 使 用 ， 具 体 的 处 理 规则 如 下 : 
(1) 处 理 布尔 类 型 时 ，Java 的 false 对 应 C/C++ 的 0, Java 的 true 对 应 C/C++ 的 1。 
(2) 处 理 字符 串 类 型 时 ，JNI 使 用 env 一 GetStringUTFChars 方法 将 jstring 类 型 转 为 const 
char* 类 型 ， 使 用 env 一 NewStringUTF 方法 将 const char* 类 型 转 为 jstring 类 型 。 


2. 编译 规则 定义 


Android Studio 编译 C/C++ 代码 有 两 种 方式 , 分 别 是 在 build.gradle 中 编写 编译 规则 和 另外 
书写 Android.mk 定义 编译 规则 。 两 种 编译 方式 的 规则 定义 大 同 小 异 , 主要 是 规则 名 称 的 差异 ， 
编译 规则 名 称 的 对 应 关系 见 表 14-3。 


表 14-3 ”编译 规则 名 称 的 对 应 关系 




















build.gradle 的 Android.mk 的 
规则 名 称 规则 名 称 pus dig 

moduleName LOCAL MODULE | so 库 文 件 的 名 称 

无 LOCAL SRC FILES | 需要 编译 的 源 文件 

cFlags LOCAL CPPFLAGS | C++ 的 编译 标志 -fexceptions (支持 try..catch..) 

ldLibs LOCAL LDLIBS 需要 链接 的 库 ， 多 个 库 用 逗号 分 隔 | log 支持 打印 日 志 ) 
stlport_static( 表 示 使 用 STLport 

stl APP STL stl 库 的 集成 方式 IEIRA) 

abiFilters APP_ABI HIPH EATE armeabi-v7a( 表 示 高 级 的 ARM) 

号 分 隔 
3. 开发 注意 事项 


由 于 JNI 接口 使 用 另 一 种 语言 开发 ， 因 此 要 注意 克服 Java 单独 编码 或 C/C++ 单独 编码 的 
固定 思维 ， 需 要 注意 以 下 事项 : 

(D C/C++ 代码 中 的 变量 都 要 初始 化 ， 因 为 在 真 机 上 如 果 不 初始 化 ， 值 就 不 可 预知 ， 进 
而 影响 业务 逻辑 处 理 。 

(2) 由 于 JNI 的 接口 名 称 包 含 包 名 、 类 名 和 函数 名 ， 因 此 务必 保证 该 名 称 所 表达 的 路 径 
与 Java 代码 完全 一 致 ， 才 能 由 Java 代码 正常 调用 JNI 接口 。 

(3) JNI 中 操作 socket 要 设置 上 网 权限 ， 否 则 socket 函数 总 是 返回 -1;， 以 此 类 推 ，JNI 
中 操作 SD 卡 文件 存 取 也 要 设置 SD 卡 权限 。 

接 下 来 通过 一 个 获取 CPU 指令 集 的 例子 演示 一 下 JNI 开发 的 完整 流程 和 基本 数据 类 型 的 
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转换 。 下 面 是 JNI 代码 文件 get_cpu.cpp 的 源 代码 : 


#include <jni.h> 
#include <string.h> 
#include <stdio.h> 


extern "C" 


jstring Java com example mixture JniCpuActivity cpuFromJNI( JNIEnv* env, jobject thiz, jint i1, jfloat f1, 
jdouble d1, jboolean b1 ) í 
Tifdefined( arm ) 
if defined( ARM ARCH 7A ) 
Tif defined( ARM NEON ) 
#if defined( ARM PCS VFP) 
#define ABI "armeabi-v7a/NEON (hard-float)" 
#else 
#define ABI "armeabi-v7a/NEON" 
#endif 
#else 
#if defined( ARM PCS VFP) 
#define ABI "armeabi-v7a (hard-float)" 
#else 
#define ABI "armeabi-v7a" 
#endif 
#endif 
#else 
#define ABI "armeabi" 
#endif 
#elif defined( i386 ) 
#define ABI "x86" 
Welif defined. x86 64 ) 
#define ABI "x86. 64" 
#elif defined( — mips64) /* mips64el-* toolchain defines  mips — too */ 
#define ABI "mips64" 
#elif defined( mips ) 
#define ABI "mips" 
#elif defined(  aarch64  ) 
#define ABI "arm64-v8a" 
else 
#define ABI "unknown" 
#endif 
char desc[200] = {0}; 
sprintf(desc, "%d %f %lf %u \nHello from JNI! Compiled with %s.", il, fl; dl, b1, ABD; 
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return env->NewStringUTF(desc); 
; 


下 面 是 活动 页 面 的 Java 代码 , 先 从 Build 类 获取 当前 的 指令 集 , 再 调用 JNI 接 口 获 取 C++ 
代码 得 到 的 指令 集 : 


public class JniCpuActivity extends AppCompatActivity implements OnClickListener { 
private TextView tv_cpu_build; 
private TextView tv cpu jni; 


@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity jni cpu); 
tv cpu build = (TextView) findViewById(R.id.tv cpu build); 
tv cpu jni = (TextView) findViewById(R.id.tv cpu jni); 
findViewById(R.id.btn cpu).setOnClickListener(this); 
tv cpu. build.setText("Build 类 获得 的 CPU JR< E Jj" Build.CPU ABI); 
j 


@Override 
public void onClick(View v) { 
if (v.getId() = R.id.btn cpu) í 
String desc = cpuFromJNI(1, 0.5f, 99.9, true); 
tv cpu jni.setText(desc); 


j 


public native String cpuFromJNl(int il, float f1, double d1, boolean b1); 
public native String unimplementedCpuFromJNl(int il, float f1, double d1, boolean b1); 
static í 

System.loadLibrary("jni mix"); 


j 


JNI 接口 获取 指令 集 的 结果 如 图 14-15 和 图 14-16 所 示 。 图 14-15 所 示 为 模拟 器 上 的 运行 
结果 截图 。 图 14-16 所 示 为 真 机 上 的 运行 结果 截图 。 





Build 类 获得 的 CPU 指 令 集 为 x86 Build 类 获得 的 CPU 指 令 集 为 armeabi-v7a 
调用 JNI 接 口 获取 指令 集 调用 JNI 接 口 获 取 指 令 集 

1 0.500000 99.900000 1 1 0.500000 99.900000 1 

Hello from JNI! Compiled with armeabi-v7a. Hello from JNI ! Compiled with armeabi-v7a. 





图 14-15 ”模拟 器 获得 的 指令 集 图 14-16 真 机 获得 的 指令 集 
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14.2.3 ”JNI 实 现 加 解密 


实际 开发 中 ，JNI 主要 应 用 于 如 下 业务 场景 : 
1. 对 关键 业务 数据 进行 加 解密 


HR Java 提供 了 常用 的 加 解密 方法 , 但 是 Java 代码 容易 遭 到 破解 , 而 so 库 到 目前 为 止 是 
不 可 破解 的 ， 所 以 使 用 JNI 进行 加 解密 无 疑 更 加 安全 。 


2. 底层 的 网 络 操作 与 设备 操作 


Java 作为 一 门 高 级 语言 ， 与 硬件 和 网 络 操作 的 阳 闵 比 C/C++ 大 ， 不 像 C/C++ 那样 容易 驾 
驭 底层 操作 。 


3. 对 运行 效率 要 求 较 高 的 场合 


同样 的 操作 , C/C++ 的 执行 效率 比 Java 高 得 多 ,iOS 基于 C/C++ 的 变种 ObjectC, Android 
基于 Java, 所 以 iOS 的 流畅 性 强 于 Android. Android 上 的 SQLite 使 用 Java 实现 ， 因 此 性 能 存 
在 瓶颈 。 现 在 移动 端 兴起 了 第 三 方 的 数据 库 Realm, 性 能 优异 渐 有 取代 SQLite 之 势 , 而 Realm 
的 底层 是 用 C/C++ 实现 的 。 


4. 跨 平 台 的 应 用 移植 


移动 设备 的 操作 系统 不 是 Android 就 是 iOS， 现 在 企业 开发 App 一 般 都 要 做 两 条 产品 线 ， 
-条 做 Android， 另 一 条 做 iOS， 同 样 的 功能 需要 两 边 分 别 实 现 ， 费 时 费力 。 如 果 部 分 业务 功 
能 采用 C/C++ 实 现 ， 那 么 不 但 Android 可 以 通过 JNI 调用 ， 而 且 ios 能 直接 编译 运行 ， 一 份 代 
码 可 同时 被 两 个 平台 复 用 ， 省 时 省 力 。 
接 下 来 我 们 尝试 使 用 JNI 完成 加 解密 操作 。C/C++ 的 加 解密 算法 代码 不 少 ， 本 书 采 用 的 是 
C++ 的 AES 算法 开源 代码 ， 主 要 的 改造 工作 是 给 C++ 源 代 码 配 上 JNI 接口 。 
下 面 是 JNI 接口 的 AES 加 密 代码 : 
#include <jni.h> 
#include <string.h> 
#include <stdio.h> 
#include "aes.h" 
#include <android/log.h> 
// log 标签 
#define TAG "MyMsg" 
/ 定义 info 信息 
#define LOGI(..) android log prin(ANDROID LOG INFO,TAG, VA ARGS ) 


extern "C" 


jstring Java com example mixture JniSecretActivity encryptFromJNI( JNIEnv* env, jobject thiz, jstring 
raw, jstring key) { 
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const char* str raw; 
const char* str key; 
str raw = env-»GetStringUTFChars(raw, 0); 
str key = env-»GetStringUTF Chars(key, 0); 
LOGI("str raw=%s, str_ key=%s ", str raw, str key); 
char encrypt[1024] = {0}; 
AES aes en((unsigned char*)str key); 
aes en.Cipher((char*)str raw, encrypt); 
LOGI("encrypt=%s", encrypt); 
return env->NewStringUTF (encrypt); 

} 


下 面 是 JNI 接口 的 AES 解密 代码 : 


#include <jni.h> 

#include <string.h> 

#include <stdio.h> 

#include "aes.h" 

#include <android/log.h> 

/log 标签 

#define TAG "MyMsg" 

/ 定义 info 信息 

#define LOGI(..) android log print(ANDROID LOG INFO,TAG, VA ARGS ) 


extern "C" 


jstring Java com example mixture JniSecretActivity decryptFromJNI( JNIEnv* env, jobject thiz, jstring des, 
jstring key) { 
const char* str des; 
const char* str key; 
str des = env-»GetStringUTFChars(des, 0); 
str key = env-»GetStringUTF Chars(key, 0); 
LOGI("str_des=%s, str key=%s ", str des, str key); 
char decrypt[1024] = {0}; 
AES aes de((unsigned char*)str key); 
aes de.InvCipher((char*)str des, decrypt); 
LOGI("decrypt=%s", decrypt); 
return eny--NewStringUTF(decrypt); 
; 
下 面 是 活动 页 面 的 Java 代码 ， 通 过 界面 对 输入 数据 进行 加 解密 操作 : 
public class JniSecretActivity extends AppCompatActivity implements OnClickListener { 
private EditText et_origin; 
private EditText et_encrypt; 
private TextView tv_cpu_build; 
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private TextView tv decrypt; 
private String mKey = "123456789abcdef"; /该 算法 要 求 密 钥 值 长 度 为 16 位 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity jni secret); 
et origin = (EditText) findViewByld(R.id.et origin); 
et encrypt — (EditText) findViewById(R.id.et encrypt); 
tv decrypt = (TextView) findViewById(R.id.tv decrypt); 
findViewById(R.id.btn encrypt).setOnClickListener(this); 
findViewById(R.id.btn decrypt).setOnClickListener(this); 

j 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.btn_encrypt) í 
String des = encryptFromJNI(et_origin.getText().toString(), mKey); 
et encrypt.setText(des); 
) else if (v.getId() = R.id.btn decrypt) í 
String raw = decryptFromJNl(et encrypt.getText().toString(), mKey); 
tv. decrypt.setText(raw); 


} 


public native String encryptFromJNI(String raw, String key); 
public native String unimplementedEncryptFromJNl(String raw, String key); 
public native String decryptFromJNI(String des, String key); 
public native String unimplementedEecryptFromJNl(String des, String key); 


static { 
System.loadLibrary("jni mix"); 


) 
JNI 实现 加 解密 的 效果 如 图 14-17 和 图 14-18 所 示 。 图 14-17 所 示 为 输入 原始 字符 串 并 调用 
JNI 接口 进行 加 密 的 结果 界面 。 图 14-18 所 示 为 对 加 密 串 进行 JNI 解密 操作 的 结果 界面 。 





ABCB888 ABC888 
调用 JNI 接 口 获取 加 密 串 调用 JNI 接 口 获取 加 密 串 
35E46A721F4483687547C9BE7D5262F0 35E46A721F4483687547C9BE7D5262F0 
调用 JNI 接 口 获 取 解 密 串 调用 JNI 接 口 获取 解密 串 
ABC888 








图 14-17 JNI 的 加 密 结 果 图 14-18 JNI 的 解密 结果 
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14.3 ”局 域 网 共享 








本 节 介 绍 融 合 技术 的 一 个 重要 方向 局 域 网 共享 ， 包 括 文件 在 内 的 手机 资源 都 有 可 能 
利用 局 域 网 技术 分 享 给 其 他 设备 。 本 节 首 先 说 明 如 何 使 用 无 线 网 络 管理 器 获取 当前 的 WIFI 信 
息 ,然后 详细 阐述 蓝牙 技术 的 4 个 工具 组 件 , 以 及 如 何 利用 蓝牙 技术 实现 两 台 设备 之 间 的 消息 
传递 。 





14.34 无 线 网 络 管理 器 WifiManager 


第 10 章 提 到 ，App 若 想 访问 外 网 资源 ， 得 先 判断 网 络 连接 是 否 可 用 。 当 时 检测 连接 的 工 
具 采 用 了 连接 管理 器 ConnectivityManager， 上 网 方式 主要 有 两 种 ， 即 数据 连接 和 WIFI。 不 过 
ConnectivityManager 只 能 笼统 的 判断 能 和 否 上 网 ， 并 不 能 获知 WIFI 连接 的 详细 信息 。 当 前 网 络 
类 型 是 WIFI 时 ， 要 想 得 知 WIFI 上 网 的 具体 信息 ， 需 另外 通过 无 线 网 络 管理 器 WifiManager 
获取 。 

WifiManager 的 对 象 从 系统 服务 Context. WIFI SERVICE 中 获取 。 下 面 是 WifiManager 的 
常用 方法 。 

e isWifiEnabled: 判断 WLAN 功能 是 否 开启 。 

e setWifiEnabled: 开启 或 关闭 WLAN 功能 。 

e getWifiState: 获取 当前 的 WIFI 连接 状态 。WIFI 连接 状态 的 取 值 说 明 见 表 14-4。 


表 14-4 WIFI 连接 状态 的 取 值 说 明 














WifiManager 类 的 连接 状态 说 明 

WIFI STATE_DISABLED 已 断 开 WIFI 
WIFI STATE_DISABLING 正在 断 开 WIFI 
WIFI STATE ENABLED 已 连 上 WIFI 
WIFI STATE ENABLING 正在 连接 WIFI 
WIFI STATE UNKNOWN 连接 状态 未 知 


e getConnectionInfo: 获取 当前 WIFI 的 连接 信息 。 该 方法 返回 一 个 Wifilnfo 对 象 ， 通 过 该 
对 象 的 各 个 方法 可 获得 更 具体 的 WIFI 设备 信息 。 下 面 是 信息 获取 方法 说 明 。 
> getSSID: WIFI 路 由 器 MAC. 
> getRssi: WIFI 信号 强度 。 
> getLinkSpeed: 连接 速率 。 
> getNetworkld: WIFI 的 网 络 编号 。 
> getlpAddress: 手机 的 IP 地 址 。 整 型 数 ， 需 转换 为 常见 的 IPv4 地 址 。 
» getMacAddress: 手机 的 MAC 地 址 。 


e startScan: 开始 扫描 周围 的 WIFI 信息 。 
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getScanResults: 获取 WIFI 的 扫描 结果 。 
calculateSignalLevel: 根据 信号 强度 计算 信号 等 级 。 
getConfiguredNetworks: 获取 已 配置 的 网 络 信息 。 
addNetwork: 添加 指定 的 WIFI 连接 。 

enableNetwork: 启用 指定 的 WIFI 连接 . 第 二 个 — emo 
参数 表示 是 否 同时 禁用 其 他 WIFI。 


当前 联网 的 网 络 类 型 是 WIFI， 状 态 是 已 连接 。 


e disableNetwork: 禁用 指定 的 WIFI 连接 。 WIFI 名 称 是 :“ChinaNet-yWXX" 
e disconnect: BEJ XN iY WIFI 连接 。 Bs CE: d8490bfbaf77 


查看 WIFI 连接 信息 的 实现 代码 很 简单 , 读者 可 自 


行 实践 。WIFI 信息 的 查看 效果 如 图 14-19 所 示 ， 主 要 sasa. 人 


包括 WIFI 路 由 器 的 相关 信息 、 手 机 在 该 WIFI 环境 下 " 
分 配 到 的 IP 地 址 和 MAC 地 址 。 TUE A 





14.3.2 ”蓝牙 BlueTooth 


无 论 是 WIFI 还 是 4G 网 络 ， 建 立 网 络 连接 后 都 是 访问 互联 网 资源 ， 并 不 能 直接 访问 局 域 

网 资源 。 比 如 两 个 人 在 一 起 ，A 要 把 手机 上 的 视频 传 给 B， 通 常情 况 是 打开 手机 QQ， 通 过 

QQ 传送 文件 给 对 方 。 不 过 上 传 视频 很 耗 流 量 ， 如 果 现 场 没有 可 用 的 WIFI， 手 机 的 数据 流量 

又 不 足 ， 就 只 能 干 瞪眼 了 。 为 解决 这 种 邻近 传输 文件 的 问题 ， 蓝 牙 技术 应 运 而 生 。 蓝 牙 技术 是 
-种 无 线 技术 标准 ， 可 实现 设备 之 间 的 短 距离 数据 交换 。 

Android 为 蓝牙 技术 提供 了 4 个 工具 类 ， 分 别 是 蓝牙 适配器 BuletoothAdapter、 蓝 牙 设 备 

BluetoothDevice、 蓝 牙 服务 端 套 接 字 BluetoothServerSocket 和 蓝牙 客户 端 套 接 字 BluetoothSocket。 


1. 蓝牙 适配器 BuletoothAdapter 


BuletoothAdapter 的 作用 其 实 跟 其 他 的 ***Manager 差不多 ， 可 以 把 它 当 作 蓝 牙 管理 器 。 下 
面 是 BuletoothAdapter 的 常用 方法 说 明 。 


e getDefaultAdapter: 静态 方法 ， 获 取 默 认 的 蓝牙 适配器 对 象 。 

e enable: 打开 蓝牙 功能 。 该 方法 在 打开 蓝牙 时 不 会 弹出 提示 ， 所 以 一 般 不 这 么 调用 。 更 

常见 的 做 法 是 弹出 对 话 框 ， 提 示 用 户 是 否 允 许 外 部 发 现 本 设备 。 因 为 只 有 让 外 部 设备 发 

现 本 设备 ， 才 能 够 进行 后 续 配 对 与 连接 操作 。 弹 窗 提示 用 户 打 开 蓝 牙 功能 的 代码 如 下 : 
Intent intent = new Intent(BluetoothAdapter ACTION. REQUEST. DISCOVERABLE); 
startActivityForResult(intent, 1); 

disable: 关闭 蓝牙 功能 。 

isEnabled: 判断 蓝牙 功能 是 否 打开 。 已 打开 就 返回 true， 否 则 返回 false. 

startDiscovery: 开始 搜索 周围 的 蓝牙 设备 。 搜 索 结 果 通 过 广播 返回 。 

cancelDiscovery: 取消 搜索 操作 。 

isDiscovering: 判断 当前 是 否 正在 搜索 设备 。 

getBondedDevices: 获取 已 绑 定 的 设备 列表 。 该 方法 返回 的 是 已 绑 定 设备 的 历史 记录 ， 而 
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2. 


非 当 前 能 够 连接 的 设备 。 

setName: 设置 本 机 的 蓝牙 名 称 。 

getName: 获取 本 机 的 蓝牙 名 称 。 

getAddress: 获取 本 机 的 蓝牙 地 址 。 

getRemoteDevice: 根据 蓝牙 地 址 获取 远程 的 蓝牙 设备 。 

getState: 获取 本 地 蓝牙 适配器 的 状态 。 值 为 BluetoothAdapter.STATE_ON 表示 蓝牙 可 用 。 
listenUsingRfcommWithServiceRecord: 根据 名 称 和 UUID 创建 并 返回 BluetoothServerSocket. 
listenUsingRfcommOn: 根据 渠道 编号 创建 并 返回 BluetoothServerSocket. 


蓝牙 设备 BluetoothDevice 


BluetoothDevice 用 于 指 代 某 个 蓝牙 设备 ， 通 常 表示 对 方 设备 。BuletoothAdapter 管理 的 是 
本 机 的 蓝牙 设备 。 下 面 是 BluetoothDevice 的 常用 方法 说 明 。 


getName: 获得 该 设备 的 名 称 。 
getAddress: 获得 该 设备 的 地 址 。 
getBondState: 获得 该 设备 的 绑 定 状态 。 蓝 牙 设备 绑 定 状态 的 取 值 说 明 见 表 14-5。 


表 14-5 ”蓝牙 设备 绑 定 状态 的 取 值 说 明 





BluetoothDevice 类 的 绑 定 状态 说 明 

BOND NONE 未 绑 定 〈 未 配对 ) 
BOND_BONDING 正在 绑 定 〈 正 在 配对 ) 
BOND_BONDING 已 绑 定 〈 已 配对 ) 


createBond: 创建 配对 请 求 。 配 对 结果 通过 广播 返回 。 
createRfcommSocketToServiceRecord: 根据 UUID 创建 并 返回 一 个 BluetoothSocket。 
createRfcommSocket: 根据 渠道 编号 创建 并 返回 一 个 BluetoothSocket. 


. 蓝牙 服务 端 套 接 字 BluetoothServerSocket 


BluetoothServerSocket 是 服务 端的 Socket， 用 来 接收 客户 端的 socket 连接 请 求 。 下 面 是 常 














4. 


方法 说 明 。 





accept: 监听 外 部 的 蓝牙 连接 请 求 。 一 旦 有 请 求 接 入 ， 就 返回 一 个 BluetoothSocket 对 象 。 
close: 关闭 服务 端的 蓝牙 监听 。 


蓝牙 客户 端 套 接 字 BluetoothSocket 


BluetoothSocket 是 客户 端的 Socket, 用 于 与 对 方 设 备 进行 数据 通信 。 下 面 是 常用 方法 说 明 。 


connect: 建立 蓝牙 的 socket 连接 。 

close: 关闭 蓝牙 的 socket 连接 。 

getlnptuStream: 获取 socket 连接 的 输入 流 对 象 。 
getOutputStream: 获取 socket 连接 的 输出 流 对 象 。 
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e getRemoteDevice: 获取 远程 设备 信息 ， 即 与 本 设备 建立 socket 连接 的 远程 蓝牙 设备 。 


上 述 工具 的 介绍 有 点 枯燥 乏味 ， 接 下 来 演示 使 用 蓝牙 建立 连接 、 发 送 消息 的 完整 流程 ， 
有 了 直观 印象 才能 进一步 理解 蓝牙 开发 的 具体 过 程 。 完 整流 程 主要 分 为 以 下 5 个 步 又: 


1. 开启 蓝牙 功能 mixture 


准备 两 部 手机 ， 各 自 安装 蓝牙 演示 App。 首 先 打 开演 
示 App 的 蓝牙 页 面 ， 一 开始 两 部 手机 的 蓝牙 功能 均 为 关 
闭 ， 初 始 状 态 的 页 面 效 果 如 图 14-20 所 示 。 

分 别 点 击 两 部 手机 左上 角 的 开关 按钮 ,准备 开启 手机 ”图 1420 蓝牙 DEMO 工程 的 初始 页 面 
的 蓝牙 功能 。 两 部 手机 都 弹出 一 个 确认 对 话 框 , 提示 用 户 是 否 允许 其 他 设备 检测 到 本 手机 。 此 
时 ，A 手机 的 授权 弹 窗 页 面 如 图 14-21 所 示 ，B 手机 的 授权 弹 窗 页 面 如 图 14-22 所 示 。 








mixture 应 用 , 想 要 打开 蓝牙 , 以 便 其 他 设 
备 在 120 秒 内 可 检测 到 您 的 手机 。 





1421 A 手机 的 授权 弹 窗 图 14-22 B 手机 的 授权 弹 窗 
当然 ， 都 要 点 击 “ 允许” 按钮 确认 开启 蓝牙 功能 。 稍 等 一 会 儿 ， 两 部 手机 分 别 检测 到 了 
对 方 设备 的 存在 ， 把 对 方 设备 显示 在 页 面 上 ， 状 态 为 “未 绑 定 ”。 此 时 A 手机 的 页 面 信息 如 
图 14-23 所 示 ，B 手机 的 页 面 信息 如 图 14-24 所 示 。 


mixture mixture 


(0 >= 蓝牙 设备 搜索 完成 


名 称 地 址 状态 


Lenovo A808t AC:38:70:3F:B6:6A RHE 64:CC:2E:77:53:5A RHE 





图 14-23. A 手机 发 现 对 方 图 14-24 B 手机 发 现 对 方 
2. 确认 配对 并 完成 绑 定 


在 任意 一 部 手机 上 点 击 对 方 设 备 的 记录 ， 表 示 发 起 配对 请 求 。 两 部 手机 都 弹出 一 个 确认 
对 话 框 ， 提 示 用 户 是 否 将 本 机 与 对 方 设备 进行 配对 。 此 时 ，A 手机 的 配对 弹 窗 页 面 如 图 14-25 
所 示 ，B 手机 的 配对 弹 窗 页 面 如 图 14-26 所 示 。 

两 边 分 别 点 击 “ 配 对 ”按钮 ， 确 认 与 对 方 进行 配对 操作 。 配 对 完成 后 ， 蓝 牙 页 面 上 将 对 
方 设备 的 状态 改 为 “已 绑 定 ”。 此 时 ，A 手机 的 页 面 信息 如 图 14-27 所 示 ，B 手机 的 页 面 信息 
如 图 14-28 所 示 。 
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蓝牙 配对 请 求 


蓝牙 配对 请 求 


设备 
Lenovo A808t (B66A) 


配对 码 要 与 以 下 设备 配对 


707653 小 六 手机 


配对 之 后 , 所 配对 的 设备 将 可 以 在 建立 连接 
后 访问 您 的 通讯 录 和 通话 记录 。 707653 


取消 





14-25 A 手机 的 配对 弹 窗 K 14-26 B 手机 的 配对 弹 窗 


mixture mixture 


(0 >= 正在 搜索 蓝牙 设备 


名 称 地 址 状态 
Lenovo A808t AC:38:70:3F:B6:6A (WE 





图 14-27. A 手机 完成 配对 图 14-28 B 手机 完成 配对 
3. 建立 蓝牙 连接 


在 任意 一 部 手机 上 点 击 已 绑 定 的 设备 记录 ， 表 示 发 起 连接 请 求 。 具 体 地 说 ， 首 先是 客户 
端的 BluetoothSocket 调用 connect 方法 ， 然 后 服务 端 BluetoothServerSocket 的 accept 方法 接收 
连接 请 求 , 于 是 双方 成 功 建立 连接 .有 的 手机 可 能 会 弹 窗 提示 “应 用 *#* 想 与 ##* 设 备 进行 通信 ” 
点 击 弹 窗 的 “确定 ”按钮 即 可 放行 。 建 立 连 接 后 ， 设 备 记录 右边 的 状态 值 改 为 “已 连接 ”。 此 
HJ, A 手机 的 页 面 信息 如 图 14-29 所 示 ，B 手机 的 页 面 信息 如 图 14-30 所 示 。 





qos 连接 成 功 qos 正在 搜索 蓝牙 设备 


名 称 地 址 状态 名 称 地 址 状态 
Lenovo A808t AC:38:70:3F:B6:6A ”已 连接 小 米 手机 64:CC:2E:77:53:5A 已 连接 
图 14-29 A 手机 与 对 方 建立 连接 图 14-30 B 手机 与 对 方 建立 连接 








4. 通过 蓝牙 发 送 消息 


在 A 手 机 上 点 击 已 连接 的 设备 记录 ， 表 示 想 要 发 送 消息 。 于 是 A 手机 弹出 文字 输入 对 话 
框 ， 提 示 用 户 输入 待 发 送 的 消息 文本 ， 文 字 输入 框 效 果 如 图 14-31 所 示 。 点 击 “ 确 定 ”按钮 发 
送 消 息 ，B 手机 接收 到 A 手机 发 来 的 消息 ， 就 把 该 消息 文本 通过 弹 窗 显示 出 来 ，B 手机 的 消 
息 弹 窗 效果 如 图 14-32 所 示 。 
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真 高 兴 认识 你 








图 14-31 A 手机 准备 向 对 方 发 送 消息 E 14-32 B 手机 收 到 对 方 发 来 的 消息 


至 此 ， 一 个 完整 的 蓝牙 应 用 过 程 就 全 部 呈现 出 来 了 。 上 面 的 流程 仅 实现 了 简单 的 字符 串 
传输 ， 真实 场景 更 需要 文件 传输 。 当然, 使 用 输入 输出 流 操作 文件 也 不 是 什么 难事 。 不 过 蓝牙 
开发 需要 两 部 手机 一 起 操作 ,确实 有 点 复杂 ， 中 间 还 有 不 少 坑 ， 真是 一 言 难 尽 。 读 者 不 如 自行 
阅读 demo 源码 并 动手 实践 ， 这 样 才能 收获 真知 灼 见 。 

注意 使 用 蓝牙 功能 需要 为 App IRI, BIZE AndroidManifest.xml 中 增加 如 下 权限 定义 : 


<!-- 蓝牙 -> 
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" > 
<uses-permission android:name="android.permission.BLUETOOTH" /> 


下 面 是 建立 蓝牙 连接 并 发 送 消息 的 页 面 代码 ， 服 务 端 与 客户 端 通用 ， 更 多 任务 代码 见 本 
书 的 下 载 资 源 : 
public class BluetoothActivity extends AppCompatActivity implements 

OnClickListener, OnItemClickListener, OnCheckedChangeListener, 
BlueConnectListener, InputCallbacks, BlueAcceptListener í 

private static final String TAG = "BluetoothActivity"; 

private CheckBox ck bluetooth; 

private TextView tv discovery; 

private ListView lv bluetooth; 

private BluetoothAdapter mBluetooth; 

private ArrayList<BlueDevice> mDeviceList = new ArrayList«BlueDevice-(); 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity_bluetooth); 
ck bluetooth = (CheckBox) findViewById(R.id.ck_bluetooth); 
tv_discovery = (TextView) findViewByld(R.id.tv_discovery); 
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lv bluetooth = (ListView) findViewById(R.id.lv bluetooth); 

if (BluetoothUtil.getBlueToothStatus(this) — true) í 
ck bluetooth.setChecked(true); 

; 

ck bluetooth.setOnCheckedChangeL istener(this); 

tv. discovery.setOnClickL istener(this); 

mBluetooth — BluetoothAdapter.getDefaultA dapter(); 

if (mBluetooth == null) í 
Toast.makeText(this, "本 机 未 找到 蓝牙 功能 ", Toast.LENGTH SHORT ).show(); 
finish(); 


j 


@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (buttonView.getId() = R.id.ck bluetooth) í 
if (isChecked = true) í 
beginDiscovery(); 
Intent intent = new Intent(BluetoothA dapter.ACTION REQUEST DISCOVERABLE); 
startActivityForResult(intent, 1); 
// 下 面 这 行 代码 为 服务 端 需要 ， 客 户 端 不 需要 
mHandler.postDelayed(mAccept, 1000); 
} else { 
cancelDiscovery(); 
BluetoothUtil.setBlueToothStatus(this, false); 
mDeviceList.clear(); 
BlueListAdapter adapter = new BlueListAdapter(this, mDeviceList); 
lv bluetooth.setAdapter(adapter); 


j 


private Runnable mAccept = new Runnable() í 
@Override 
public void run() { 
if (mBluetooth.getState() = BluetoothAdapter.STATE_ON) í 
BlueAcceptTask acceptTask = new BlueAcceptTask(true); 
acceptTask.setBlueAcceptListener(BluetoothActivity.this); 
acceptTask.executeOnExecutor(AsyncTask.THREAD POOL EXECUTOR); 
) else í 
mHandler.postDelayed(this, 1000); 
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(@Override 
public void onClick(View v) í 
if (v.getld() = R.id.tv discovery) í 
beginDiscovery(); 


j 


@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent intent) í 
super.onActivityResult(requestCode, resultCode, intent); 
if (requestCode = 1) { 
if (resultCode — RESULT OK) í 
Toast.makeText(this, "允许 本 地 蓝牙 被 附近 其 他 蓝牙 设备 发 现 "， 
Toast. LENGTH_SHORT).show(); 
} else if (resultCode = RESULT CANCELED) ( 
Toast.makeText(this, "不 允许 蓝牙 被 附近 其 他 蓝牙 设备 发 现 ", 
Toast. LENGTH_SHORT).show(); 
j 


private Runnable mRefresh = new Runnable() í 
@Override 
public void run() { 
beginDiscovery(); 
mHandler.postDelayed(this, 2000); 


h 


private void beginDiscovery() í 
if (mBluetooth.isDiscovering() != true) í 
mDeviceList.clear(); 
BlueListAdapter adapter = new BlueListAdapter(BluetoothActivity.this, mDeviceList); 
lv bluetooth.setAdapter(adapter); 
tv_discovery.setText(" 正 在 搜索 蓝牙 设备 "); 
mBluetooth.startDiscovery(); 


j 


private void cancelDiscovery() f 
mHandler.removeCallbacks(mRefresh); 
tv_discoverysetText(" 取 消 搜索 蓝牙 设备 ); 
if (mBluetooth.isDiscovering() = true) í 

mBluetooth.cancelDiscovery(); 
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@Override 

protected void onStart() { 
super.onStart(); 
mHandler.postDelayed(mRefresh, 50); 
blueReceiver = new BluetoothReceiver(); 
/需要 过 滤 多 个 动作 ， 则 调用 IntentFilter 对 象 的 addAction 添加 新 动作 
IntentFilter foundFilter = new IntentFilter(BluetoothDevice.ACTION FOUND); 
foundFilter.addAction(BluetoothAdapter.ACTION DISCOVERY FINISHED); 
foundFilter.addAction(BluetoothDevice.ACTION BOND STATE CHANGED); 
registerReceiver(blueReceiver, foundFilter); 

1 

@Override 

protected void onStop() í 
super. onStop(); 
cancelDiscovery(); 


unregisterReceiver(blueReceiver); 
i 


private BluetoothReceiver blueReceiver; 

private class BluetoothReceiver extends BroadcastReceiver í 
(@Override 
public void onReceive(Context context, Intent intent) í 

String action = intent.getAction(); 

Log.d(TAG, "onReceive action="+action); 

/ 获得 已 经 搜索 到 的 蓝牙 设备 

if (action.equals(BluetoothDevice.ACTION FOUND)) { 

BluetoothDevice device — intent.getParcelableExtra(BluetoothDevice.EXTRA DEVICE); 

BlueDevice item = new BlueDevice(device.getName(), device.getAddress(), 
device.getBondState()-10); 

mDeviceList.add(item); 

BlueListAdapter adapter = new BlueListAdapter(BluetoothActivity.this, mDeviceList); 

lv bluetooth.setAdapter(adapter); 

lv bluetooth.setOnItemClickListener(BluetoothActivity.this); 

} else if (action.equals(BluetoothAdapter.ACTION DISCOVERY FINISHED)) í 
mHandler.removeCallbacks(mRefresh); 
tvy_discovery.setText(" 蓝 牙 设备 搜索 完成 "); 

} else if (action.equals(BluetoothDevice.ACTION BOND STATE CHANGED)) í 
BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice. EXTRA. DEVICE); 
if (device.getBondState() = BluetoothDevice.BOND BONDING) ( 

tv. discovery.setText(" [EZEROX" 4 device.getName()); 
} else if (device.getBondState() == BluetoothDevice.BOND BONDED) { 
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tv_discovery.setText(" 完 成 配对 "+device.getName()); 
mHandler.postDelayed(mRefresh, 50); 

} else if (device.getBondState() == BluetoothDevice.BOND NONE) í 
tv_discovery.setText(" 取 消 配 对 "+device.getName()); 


} 


@Override 
public void onltemClick(AdapterView<?> parent, View view, int position, long id) { 
cancelDiscovery(); 
BlueDevice item = mDeviceList.get(position); 
BluetoothDevice device = mBluetooth.getRemoteDevice(item.address); 
try ( 
if (device.getBondState() — BluetoothDevice.BOND NONE) í 
Method createBondMethod = BluetoothDevice.class.getMethod("createBond"); 
Log.d(TAG, "开始 配对 "); 
Boolean result = (Boolean) createBondMethod.invoke(device); 
} else if (device.getBondState() = BluetoothDevice.BOND BONDED && 
item.state != BlueListAdapter CONNECTED) { 
tv_discovery.setText(" 开 始 连接 "); 
BlueConnectTask connectTask = new BlueConnectTask(item.address); 
connectTask.setBlueConnectListener(this); 
connectTask.executeOnExecutor(AsyncTask. THREAD POOL EXECUTOR, device); 
} else if (device.getBondState() = BluetoothDevice.BOND BONDED && 
item.state == BlueListAdapter. CONNECTED) { 
tv_discovery.setText(" 正 在 发 送 消息 "); 
InputDialogFragment dialog = InputDialogFragment.newInstance( 
"", 0, "请 输入 要 发 送 的 消息 "); 
String fragTag = getResources().getString(R.string.app_name); 
dialog.show(getFragmentManager(), frag Tag); 
; 
} catch (Exception e) í 
e.printStackTrace(); 
tv_discovery.setText(" 配 对 异常 : "+e.getMessage()); 


} 


// 向 对 方 发 送 消 息 

@Override 

public void onInput(String title, String message, int type) í 
Log.d(TAG "onInput message-"--message); 
BluetoothUtil.writeOutputStream(mBlueSocket, message); 
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private BluetoothSocket mBlueSocket; 

// 客 户 端 主动 连接 

@Override 

public void onBlueConnect(String address, BluetoothSocket socket) { 
mBlueSocket = socket; 
tv_discovery.setText(" 连 接 成 功 "); 
refreshAddress(address); 

} 


// 刷 新 已 连接 的 状态 
private void refreshAddress(String address) í 
for (int i0; icmDeviceList.size(); i++) { 
BlueDevice item = mDeviceList.get(i); 
if (item.address.equals(address) = true) í 
item.state = BlueListAdapter. CONNECTED; 
mDeviceList.set(i, item); 


] 
BlueListAdapter adapter = new BlueListAdapter(this, mDeviceList); 


lv bluetooth.setAdapter(adapter); 
; 


/服务 端 侦 听 到 连接 
@Override 
public void onBlueAccept(BluetoothSocket socket) { 
Log.d(TAG, "onBlueAccept socket is "+(socket==null?"null":"not null")); 
if (socket != null) í 
mBlueSocket — socket; 
BluetoothDevice device = mBlueSocket.getRemoteDevice(); 
refreshAddress(device.getAddress()); 
BlueReceiveTask receive = new BlueReceiveTask(mBlueSocket, mHandler); 


receive.start(); 


h 


// 收 到 对 方 发 来 的 消息 
private Handler mHandler = new Handler() { 
@Override 
public void handleMessage(Message msg) { 
if (msg.what = 0) { 
byte[] readBuf = (byte[]) msg.obj; 
String readMsg = new String(readBuf, 0, msg.arg1); 
Log.d(TAG, "handleMessage readMessage= "+ readMsg); 
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AlertDialog.Builder builder = new AlertDialog. Builder(BluetoothActivity.this); 
buildersetTitle(" 我 收 到 消息 啦 ").setMessage(readMsg).setPositiveButton(" 确 定 ",nulD; 


builder.create().show(); 
; 
B 
h 
(@Override 
protected void onDestroy() í 
super.onDestroy(); 
if (mBlueSocket != null) í 
ty { 
mBlueSocket.close(); 
} catch (IOException e) í 
e.printStackTrace(); 
} 
J 
i 


144 KRMH: 共享 经 济 和 弄潮儿 一 一 WIFI 共享 器 


互联 网 之 所 以 成 为 新 经 济 ， 很 重要 的 一 个 原因 是 深入 贯彻 了 分 享 的 精 艇 。 从 你 有 我 无 ， 
到 人 人 共享 , 这 是 人 类 历史 上 的 一 大 进步 。 本 章 介绍 的 融合 相关 技术 从 一 起 显示 网 页 到 一 起 运 
行 代码 ， 再 到 一 起 分 享 文件 ， 其 实 都 渗透 着 共享 的 思想 。 本 章 结 尾 进 一 步 在 用 户 手机 之 间 共 享 
网 络 ， 即 共享 流量 。 具 体 地 说 ， 就 是 一 个 手机 开启 WIFI 热点 ， 其 他 设备 均 可 接 入 该 WIFI 上 
网 冲浪 ， 这 就 是 本 章 的 实战 项 目 一 一 “WIFI 共享 器 ”。 


14.4.1 设计 思 


大 家 应 该 都 有 外 出 游玩 的 经 历 ， 因 为 室外 WIFI 信号 很 弱 ， 要 么 干脆 找 不 到 公共 WIFI fii 
号 ， 所 以 在 外 玩 亦 往 往 很 消耗 手机 流量 。 有 的 朋友 用 完了 流量 ， 有 的 朋友 还 剩 不 少 流量 ， 能 不 
能 把 剩余 的 流量 给 别人 使 用 呢 ? 当然 可 以 。 现 在 不 少 手机 都 自 带 个 人 热点 /WLAN 热点 /WIFI 
热点 之 类 的 功能 ， 开 局 该 功能 即 可 将 手机 变 为 一 台 无 线路 由 器 ， 其 他 设备 连接 该 手机 的 热点 


手机 的 WIFI 热点 功能 一 般 集成 在 系统 设置 中 ， 页 面 很 简单 ， 功 能 也 相对 简单 。 现 在 我 们 
给 热点 做 一 下 功能 增强 ， 实 现 名 副 其 实 的 WIFI 共享 器 ， 页 面 效果 如 图 14-33 所 示 。 

光 看 这 个 页 面 ， 读 者 可 能 不 能 很 快 明白 采用 了 哪些 App 技术 ， 且 待 笔 者 细 细 数 来 ， 看 看 
这 个 简单 的 页 面 究竟 蕴含 哪些 江湖 绝技 。 
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CD 无 线 网 络 管理 器 WifiManager: 这 是 比较 明白 的 ， 开 关 


热点 都 要 由 WifiManager 操 作 。 
(2) 系统 文件 读 取 : 在 系统 文件 /proc/net/arp 中 ， 可 找到 qo 
已 连接 设备 列表 的 IP 和 MAC 地 址 。 WIFI 名 称 : CMAY9DG6PRJJBI99 


WIFI 密码 : 


(3) 网 络 地 址 InetAddress: 判断 某 个 设备 能 否 连 上 ， 用 到 
了 InetAddress 的 isReachable 方法 。 

(4) 异步 任务 AsyncTask: 涉及 网 络 操 作 都 要 把 处 理 逻 辑 
放 在 子 线 程 中 处 理 。 

(5) 资产 管理 器 AssetManager: 用 于 导入 MAC 地 址 与 设 
备 厂 商 的 对 应 关系 表 。 因 为 联网 设备 的 MAC 由 国际 电子 协会 
IEEE 统一 分 配 ， 未 经 认证 和 授权 的 厂家 无 权 生产 ，MAC 地 址 
的 前 6 位 代表 手机 和 电脑 厂商 ， 所 以 可 通过 MAC 地 址 查询 对 ”图 1433. ”WIFI 共享 器 的 效果 图 
应 的 厂商 名 称 。MAC 与 厂商 的 对 应 关系 可 从 http://standards.ieee.org/regauth/ oui/oui.txt 查询 。 

(6) 数据 库 SQLite: MAC 与 厂商 关系 表 要 导入 SQLite 数据 库 中 ， 方 便 后 续 查 询 操作 。 

CD. 异步 服务 IntentService: 从 assets 目录 导入 MAC 与 厂商 关系 表 ， 由 于 比较 耗 时 ， 因 
此 为 了 避免 页 面 挂 死 ， 必 须 开 启 后 台 服 务 执行 导入 操作 ， 而 且 开启 子 线程 的 异步 服务 。 

(8) 套 接 字 Socket: 使 用 socket 技术 通过 NetBIOS 协议 获取 网 络 上 的 计算 机 名 称 。 

(9) JNI 开发 : C 语言 完成 NetBIOS 协议 的 信息 获取 需要 实现 JNI 接口 供 Java 代码 调用 。 


真是 不 数 不 知 道 ， 原 来 简 简 单单 的 页 面 背后 竞 隐 藏 了 这 么 多 不 为 人 知 的 高 招 ， 所 以 不 要 
小 看 App 开发 ， 做 好 一 项 功能 往往 需要 联合 使 用 多 种 技术 。 


保存 设置 
当前 已 有 2 台 设 备 连接 
品牌 设备 名 IP 地址 MAC 地 址 


Xiaomi 小 米 — 192.168.43.12 64:CC:2E:77:53:5B 





OUYAN 
imel GSHEN 192.168.43.2 F8:16:54:A1:C4:30 








14.4.2 ”小 知识 : NetBIOS 协议 


NetBIOS 协议 是 一 种 局 域 网 上 的 应 用 程序 编程 接口 ,为 程序 提供 了 请 求 低级 服务 的 统一 命 
令 集 ,允许 程序 和 网 络 会 话 。 在 Windows 操作 系统 中 , 安装 TCP/IP 协议 后 会 自动 安装 NetBIOS。 
也 就 是 说 ，Windows 平台 自 带 NetBIOS 服务 。 

NetBIOS 提供 的 名 字 包 括 计 算 机 名 称 、 工 作 组 名 和 域名 。 从 程序 角度 来 看 ， 只 要 一 个 IP 
地 址 用 的 是 Windows 操作 系统 ， 通 过 NetBIOS 协议 即 可 获得 该 IP 的 计算 机 名 和 MAC 地 址 ， 
为 开发 者 获知 对 方 的 设备 信息 提供 了 便利 。 

其 实 ， 通 过 Java 代码 就 能 根据 IP 地 址 获取 对 方 的 计算 机 名 ， 示例 代 码 见 下 载 资源 本 章 源 
码 包 里 的 GetClientName.java， 具 体 的 执行 结果 如 图 14-34 所 示 。 





public static void main(Strine[] args) throws Exception [ 
String ip = "192. 168.0. 212^; 
GetClientName add = new GetClientName(ip).,. 
ERO; 


System. out. println( | BE tipt” 
System. out. println(add. getRenoteInfo(); 


EJ Console :: XD 


(terminated? GetClientName (1) [Java Application] D: Program Files ( 
15:192. 168. 0. 212 的 探测 结果 
192. 168. 0. 212 |OUYANGSHEN |54-EE-75-22-40-30 





图 14-34 Java 代码 实现 NetBIOS 协议 


.571 ， 
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在 底层 操作 NetBIOS 怎么 少 得 了 威名 赫赫 的 C 语言 呢 ? 正好 本 章 介绍 了 IN 开发 ， 不 妨 
使 用 C 语言 的 代码 实现 计算 机 名 的 获取 功能 。 下 面 是 完整 的 JNI 代码 ， 读 者 可 尝试 将 其 集成 
到 实战 项 目 中 : 


#include <jni.h> 
#include <string.h> 
#include <stdio.h> 
#include <stdlib.h> 
#include <string.h> 
#include <netdb.h> 
#include <sys/stat.h> 
#include <sys/types.h> 
#include <sys/select.h> 





#include <sys/socket.h> 
#include <netinet/in.h> 
#include <arpa/inet.h> 


#define send MAXSIZE 50 

#define recv_MAXSIZE 1024 

struct NETBIOSNS í 
unsigned short int tid; /lunsigned short int 占 2 字 节 
unsigned short int flags; 
unsigned short int questions; 
unsigned short int answerRRS: 
unsigned short int authorityRRS: 
unsigned short int additionalRRS; 
unsigned char name[34]; 
unsigned short int type; 
unsigned short int classe; 

iH 


char *getNameFromlp(const char *ip); 
extern "C" 


jstring Java com example mixture WifiShareActivity nameFromJNI( JNIEnv* env, jobject thiz, jstring ip) { 
const char* str ip; 
str ip = env-»GetStringUTFChnars(ip, 0); 
return env-»NewStringUTF(getNameFromlp(str ip)); 


char *getNameFromlp(const char *ip) í 
char str info[1024] = {0}; 
struct sockaddr in toAddr; /在 sendto 中 使 用 的 对 方 地址 
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struct sockaddr in fromAddr; /在 recvfrom 中 使 用 的 对 方 主机 地 址 

char send_buff[send MAXSIZE]; 

charrecv buff[recev MAXSIZE]; 

memset(send buff, 0, sizeof(send buff)); 

memset(recv buff, 0, sizeof(recv buff)); 

int sockfd; //socket 

unsigned int udp port = 137; 

int inetat; 

if( (inetat = inet aton(ip, &toAddrsin addr)) = 0) í 
sprintf(str info, "[?6s] is not a valid IP addressn", ip); 
return str info; 

j 

if ( (sockfd = socket(AF INETSOCK DGRAM,IPPROTO UDP)) < 0) í 
sprintf(str info, "%s socket error sockfd=%d, inetat-?/od n", ip, sockfd, inetat); 
return str info; 

j 

bzero((char*)&toA ddr,sizeof(toAddr)); 

toAddrsin family = AF INET; 

toAddrsin addr.s addr = inet addr(ip); 

toAddrsin port- htons(udp port); 

/构造 NetBIOS 结构 包 

struct NETBIOSNS nbns; 

nbns.tid-0x0000; 

nbns.flags-0x0000; 

nbns.questions-0x0100; 

nbns.answerRRS-0x0000; 

nbns.authorityR RS-0x0000; 

nbns.additionalR RS-0x0000; 

nbns.name[0]-0x20; 

nbns.name[1]-0x43; 

nbns.name[2]-0x4b; 

int j=0; 

for (j=3;j<34;j++) { 
nbns.name[j]-0x41; 

h 

nbns.name[33]=0x00; 

nbns.type=0x2100; 

nbns.classe=0x0100; 

memcpy(send buff, &nbns, sizeof(nbns)); 

int send num =0; 

send num = sendto(sockfd, send buff, sizeof(send buff), 0, (struct sockaddr *)&toAddr, 

sizeof(toAddr) ); 
if(send num != sizeof(send buff)) í 
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sockfd. 


sprintf(str info, "26s sendto() error sockfd=%d, send num=%4, sizeof(send buff)-?6dWn", ip, 


.send num, sizeof(send buff)); 


shutdown(sockfd, 2); 
return str. info; 
} 
int recv_num = recvfrom(sockfd, recv buff, sizeof(recv_buff), 0, (struct sockaddr *)NULL, 


(socklen t*)NULL); 


j 


14.4. 


if(recv num < 56) í 
sprintf(str info, "%s recvfrom() error sockfd-?6d, recv num-?6dn", ip, sockfd, recv num); 
shutdown(sockfd, 2); 
return str info; 
li 
/这 里 要 初始 化 。 因 为 发 现 Linux 和 模拟 器 都 没 问题 , 真 机 上 该 变量 如 果 不 初始 化 , 值 就 不 可 预知 
unsigned short int NumberOfNames=0; 
memcpy(&NumberOfNames, recv_buff+56, 1); 
char str name[1024] = {0}; 
unsigned short int mac[6]7 (03 ; 


int i-0; 
for (i70; izNumberOfNames; i++) { 
char NetbiosName[16]; 
memopy(NetbiosName, recv_buff+57+i*18, 16); /依次 读 取 NetBIOS name 
if (i = 0) ( 
sprintf(str name, "os", NetbiosName); 
J 
; 


sprintf(str info, "%s|%s|", ip, str name); 
for (i70; i<6; i++) { 
memcepy(&mac[i], recv buff-57-NumberOfNames*18-Hi,1); 
sprintf(str info, "%s%02X", str info, mac[i]); 
if (i !=5) í 
sprintf(str info, "%s-", str info); 
; 


} 
retum str info; 


3 代码 示例 


(1) MAC 地 址 与 设备 厂商 的 对 应 关系 文件 要 放 在 assets 目录 下 。 
(2) 打开 WIFI 热点 ， 要 记得 为 AndroidManifest.xml 添加 网 络 访问 的 权限 配置 : 
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<!-- 查看 网 络 状态 -> 

<uses-permission android:name="android.permission.ACCESS NETWORK STATE" > 
<uses-permission android:name-"android.permission. ACCESS WIFI STATE" > 

<l-- WLAN — 

<uses-permission android:name="android.permission.ACCESS_WIFI STATE" /> 
<uses-permission android:name="android.permission. CHANGE WIFI STATE" /> 

<!-- 上 网 一 

<uses-permission android:name="android.permission.INTERNET" > 


(3) 在 AndroidManifest.xml 中 注册 MAC 与 设备 的 关系 导入 服务 ， 注 册 代 码 如 下 : 
«service android:name=".service.ImportService" android:enabled="true" /> 
(4) 开关 WIFI 热点 ， 只 能 在 真 机 上 测试 ， 无 法 在 模拟 器 上 测试 。 


WIFI 热点 有 关 的 方法 说 明 。 


e setWifiApEnabled: 开启 或 关闭 WIFI 热点 。 隐 藏 方法 ， 需 通过 反射 调用 。 

e getWifiApState :获取 当前 的 WIFI 热点 状态 ，WIFI 热点 状态 的 取 值 说 明 见 表 14-6. 
表 14-6 ”WIFI 热点 状态 的 取 值 说 明 

说 明 

WIFI 热点 已 关闭 

WIFI 热点 正在 关闭 

WIFI 热点 已 开启 

WIFI 热点 正在 开启 

WIFI 热点 开启 失败 


WifiManager 类 的 WIFI 热点 状态 
WIFL AP_STATE DISABLED 
WIFI_AP_STATE DISABLING 
WIFI_AP_STATE ENABLED 
WIFI_AP_STATE ENABLING 
WIFI_AP_STATE FAILED 








e isWifiApEnabled: 判断 WIFI 热点 是 否 启用 。 只 有 已 连接 状态 才 返 回 true， 其 余 都 返回 
false。 

getWifiApConfiguration: 获取 WIFI 热点 的 配置 信息 。 

setWifiApConfiguration: 设置 WIFI 热点 的 配置 信息 。 

addToBlacklist: 把 指定 MAC 地 址 添加 到 黑 名 单列 表 ， 即 阻止 该 设备 连接 热点 。 
clearBlacklist: 清除 黑 名 单列 表 。 


有 关 的 方法 都 是 隐藏 方法 ， 这 意味 着 外 部 无 法 直接 调用 该 方法 。 
Android 因为 在 不 断 更 新 升级 ， 同 时 新 技术 层出不穷 ， 所 以 并 没有 把 所 有 公共 方法 开放 出 来 。 
查看 Android 的 SDK 源码 会 发 现 少数 公开 方法 加 上 了 hide 标记 ， 表 示 该 函数 是 隐藏 方法 ， 尚 
未 正式 开放 ,原因 可 能 是 不 稳定 或 有 待 完善 。 有 时 开发 者 确实 需要 调用 这 些 隐藏 方法 ， 这 时 需 
要 通过 Java 的 反射 机 制 间接 实现 。 反 射 机 制 指 的 是 在 运行 过 程 中 ， 程 序 能 够 调用 任意 一 个 对 
象 的 任意 公开 方法 和 属性 ， 而 不 被 hide 标记 所 束缚 。 

下 面 是 使 用 反射 机 制 实现 开关 WIFI 热点 与 获取 热点 状态 的 代码 : 
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public static String set WifiApEnabled(WifiManager wifiMgr,WifiConfiguration apConfig,boolean 


enabled) ( 


String desc = ""; 
if (apConfig.SSID == null || apConfig.SSID.length() <= 0) í 
desc = "WIFI 名 称 为 空 "; 
return desc; 
; 
ty { 
if (enabled) { 
// wifi 和 WIFI 不 能 同时 打开 ， 所 以 打开 WIFI 时 需要 关闭 wifi 
wifiMgr.setWifiEnabled(false); 
j 
/ 通过 反射 调用 设置 WIFI 
Method method = wifiMgr.getClass().getMethod("set WifiApEnabled", 
WifiConfiguration.class, Boolean.TYPE); 
// 返回 WIFI 打开 状态 
if ((Boolean) method.invoke(wifiMgr, apConfig, enabled) != true) í 
desc = "WIFI 操作 失败 "; 
i; 
) catch (Exception e) í 
e.printStackTrace(); 
desc = "WIFI 操作 异常 : " + e.getMessage(); 
j 


return desc; 


public static int getWifiApState(WifiManager wifiMgr) { 
try ( 
Method method = wifiMgr.getClass().getMethod(" get WifiApState"); 
int i = (Integer) method.invoke(wifiMgr); 
if(i»9)( 
i--10; 
j 
Log.d(TAG, "wifi states "+ D; 
return i; 
} catch (Exception e) í 
e.printStackTrace(); 
return WIFI AP. STATE FAILED; 


j 
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开关 WIFI 开关 WIFI €D 
WIFI 名 称 : CMAY9DG6PRJJBI99 WIFI 名 称 : CMAY9DG6PRJJBI99 
WIFI 密码 ; WIFI 密码 : 
MES: 无 "a 加 密 方式 : 无 v 

保存 设置 保生 设置 
当前 没有 设备 连接 当前 没有 设备 连接 
图 14-35 WIFI 共享 器 的 初始 页 面 图 14-36 开启 WIFI 热点 功能 
这 个 WIFI 热点 的 名 称 是 “CMAY9D***”， 
打开 其 他 设备 (包括 手机 和 笔记 本 电脑 ) 刷 新 wifi 


开关 WIFI €D 


WIFI 名 称 : CMAY9DG6PRJJBI99 


列表 ， 然 后 点 击 连 接 新 发 现 的 WIFI 
“CMAY9D***”， 热 点 管理 页 面 就 会 将 该 设备 加 
入 已 连接 的 设备 列表 。 如 果 是 手机 连接 ， 设 备 名 这 


WIFI 密码 : 
列 显示 的 就 是 手机 的 制造 厂商 ， 如 果 是 笔记 本 连 MUN m 3 
接 ,设备 名 这 列 显示 的 就 是 该 电脑 上 登记 的 计算 机 ms 
名 。 笔 者 测试 时 ， 热 点 管理 页 面 依次 找到 了 一 部 联 UE 


想 手机 、 一 部 苹果 手机 、 一 部 小 米 手机 ， 外 加 一 台 
计算 机 名 为 OUYANGSHEN 的 笔记 本 电脑 ， 如 图 
14-37 所 示 。 接 入 WIFI 的 设备 一 览 无 余 ， 再 也 不 用 
担心 自己 的 WIFI EP T o 
目前 ，WIFI 共享 器 主要 实现 了 3 个 功能 ， 即 
开关 热点 、 修 改 热点 配置 和 查看 已 连接 设备 信息 。 
读者 若 有 兴趣 ， 可 以 加 以 完善 ， 比 如 加 一 个 小 黑 屋 图 14-37 检测 到 已 接 入 WIFI 热点 的 设备 列表 
功能 ， 把 不 明 来 源 的 设备 加 入 黑 名 单 ， 不 让 它 连 接 本 机 热点 ; 也 可 以 加 一 个 流量 控制 功能 ， 
旦 检测 到 热点 流量 超过 闵 值 ， 就 立即 关闭 WIFI 热点 ， 避 免 不 必 要 的 流量 消耗 。 
下 面 是 WIFI 热点 管理 页 面 的 代码 : 
public class WifiShareActivity extends AppCompatActivity implements 
OnClickListener.OnCheckedChangeL istener,GetC lientListener,FindNameListener í 
private static final String TAG = "WifiShareActivity"; 
private CheckBox ck wifi switch; 
private EditText et wifi name, et wifi password; 


品牌 设备 名 。 IP 地 址 MAC 地 址 
Lenovo R — 192.168.43.39 50:3C:C4:1F:A7:96 
OUYAN 161 7 
ntel GSHEN 192168.43.2 F8:16:54:A1:C4:30 


Xiaomi 小 米 192.168.43.12 64:CC:2E:77:53:5B 








Apple SER 192.168.43.14 D0:33:11:3E:0C:76 








private Spinnersp wifi des; 

private TextView tv connect; 

private LinearLayout ll client title; 

private ListView lv. wifi client; 

private WifiManager mWifiManager; 

private WifiConfiguration mWifiConfig — new WifiConfiguration(); 
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private int mDesType = 0; 

private ArrayList<ClientScanResult> mClientArray = new ArrayList<ClientScanResult>(); 
private HashMap<String, String> mapName = new Hash Map<String, String>(); 

private Handler mHandler = new Handler(); 


(@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity wifi share); 
ck wifi switch = (CheckBox) findViewById(R.id.ck wifi switch); 
et wifi name = (EditText) findViewById(R.id.et wifi name); 
et wifi password = (EditText) find ViewById(R.id.et wifi password); 
tv connect = (TextView) find ViewById(R.id.tv connect); 
Il client title = (LinearLayout) findViewById(R.id.ll client title); 
lv wifi client = (ListView) findViewById(R.id.lv wifi client); 
findViewById(R.id.btn wifi save).setOnClickListener(this); 
et wifi name.setText(Build.SERIAL); 
et wifi password.setText(""); 
ck wifi switch.setOnCheckedChangeL istener(this); 
mWifiManager = (WifiManager) getSystemService(Context. WIFI SERVICE); 
setWifiConfig(); 


sp wifi des = (Spinner) findViewByld(R.id.sp wifi des); 

ArrayAdapter-String» starAdapter = new ArrayAdapter-String^(this, 
R.layout.item select, desNameArray); 

starAdapter.setDropDownViewResource(R.layout.item select); 

sp wifi des.setAdapter(starAdapter); 

sp wifi des.setSelection(mDesType); 

sp_wifi_des.setPrompt(" 请 选择 加 密 方式 "); 

sp wifi des.setOnItemSelectedListener(new DesTypeSelectedListener()); 

sp wifi des.setSelection(mDesType); 

mHandler.postDelayed(mClientTask, 50); 


private String[] desNameArray = {" 无 ", "WPA PSK", "WPA2 PSK"}; 
private int[] desTypeArray = (WifiConfiguration.KeyMgmt.NONE, WifiConfiguration.KeyMgmt. 
WPA PSK, 4}; 
private class DesTypeSelectedListener implements OnItemSelectedListener í 
(GQOverride 
public void onItemSelected(AdapterView-?- arg0, View arg], int arg2, long arg3) í 
mDesType = arg2; 
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@Override 
public void onNothingSelected(AdapterView<?> arg0) { 
J 


private Runnable mClientTask = new Runnable() í 
@Override 
public void run() { 
GetClientListTask getClientTask = new GetClientListTask(); 
getClientTask.setGetClientListener(WifiShareActivity.this); 
getClientTask.execute(); 
mHandler.postDelayed(this, 3000); 


h 


@Override 
public void onClick(View v) { 
if (v.getId() == R.id.btn wifi save) í 
if(et wifi name.getText().length() < 4) í 
Toast.makeText(this, "WIFI 名 称 长 度 需 不 小 于 四 位 ", ToasLLENGTH SHORT).show(); 
return; 
} else if (mDesType!=0 && et wifi password.getText().length() < 8) í 
Toast.makeText(this, "WIFI 密码 长 度 需 不 小 于 八 位 ", ToastLENGTH SHORT).show(); 
return; 
j 
Toast.makeText(this, "已 保存 本 次 WIFI 设置 " Toast. LENGTH. SHORT).show(); 
/只 有 已 开启 WIFI, 才 需 要 断 开 并 重 连 。 当前 未 开启 WIFI, 保存 设置 后 不 自动 开启 WIFI 
int timeout = 0; 
if(ck wifi switch.isChecked() = true) í 
ck wifi switch.setChecked(false); 
timeout — 2000; 
H 
setWifiConfig(); 
mHandler.postDelayed(mReOpenTask, timeout); 


private void setWifiConfig() í 
mWifiConfig.allowedKeyManagement.clear(); 
mWifiConfig.SSID —et wifi name.getText().toString(); 
if (mDesType — 0) ( 
mWifiConfig.preSharedKey = ""; 
mWifiConfig.wepKeys[0] = et wifi password.getText().toString(); 
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mWifiConfig.wepTxKeyIndex = 0; 

} else í 
mWifiConfig.allowedKeyManagement.set(desType Array[mDesType]); 
mWifiConfig.preSharedKey = et wifi password.getText().toString(); 
mWifiConfig.allowedAuthAlgorithms.set( WifiConfiguration.AuthAlgorithm.OPEN); 
mWifiConfig.allowedProtocols.set( WifiConfiguration.Protocol.RSN); 
mWifiConfig.allowedPairwiseCiphers.set(WifiConfiguration.PairwiseCipher.CCMP); 
mWifiConfig.allowedPairwiseCiphers.set(WifiConfiguration.PairwiseCipher. TKIP); 
mWifiConfig.allowedGroupCiphers.set( WifiConfiguration.GroupCipher.CCMP); 
mWifiConfig.allowedGroupCiphers.set( WifiConfiguration.GroupCipher. TKIP); 


$ 

} 

private Runnable mReOpenTask = new Runnable() { 
@Override 
public void run() { 


if (WifiUtil.getWifiApState(mWifiManager) == WifiUtil.WIFI_AP_STATE_DISABLED) í 
ck wifi switch.setChecked(true); 

} else { 
mHandler.postDelayed(this, 2000); 


h 


@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (button View.getId() == R.id.ck wifi switch) í 
String result = ""; 
if (isChecked == false) { 
result = WifiUtil.setWifiApEnabled(mWifiManager, mWifiConfig, isChecked); 
} else { 
setWifiConfig(); 
result = WifiUtil.setWifiApEnabled(mWifiManager, mWifiConfig, isChecked); 
; 
Log.d(TAG, "onCheckedChanged: "+isChecked+". "+result); 
if (result!-null && result.length()70) í 
Toast.makeText(this, result, ToasLLENGTH SHORT ).show(); 
ck wifi switch.setChecked('isChecked); 
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public void onGetClient(ArrayList<ClientScanResult> clientList) í 
mClientArray = clientList; 
Log.d(TAG, "mClientArray.size(}=" + mClientArray.size()); 
if (WifiUtil.getWifiApState(mWifiManager) != WifiUtil. WIFI AP STATE ENABLING 
&& WifiUtil.getWifiApState(mWifiManager) != WifiUtil. WIFI AP STATE ENABLED) í 
mClientArray.clear(); 
} else if (mClientArray — null) í 
mClientArray = new ArrayList«ClientScanResult*(); 
$ 
if (mClientArray.size() <= 0) { 
tv_connect.setText(" 当 前 没有 设备 连接 "); 
Il client title.setVisibility(View.GONE); 
) else í 
String desc = String.format(" 当 前 已 有 9%d 台 设 备 连接 ", mClientArray.size()); 
tv_connect.setText(desc); 
ll client title.setVisibility(View. VISIBLE); 
J 
for (int i = 0; i < mClientArray.size(); i++) { 
ClientScanResult item = mClientArray.get(i); 
String ipAddr = item.getIpAddr(); 
item.setDevice(MacManager.getInstance(this).getMacDevice(item.getH WA ddr())); 
if (mapName.containsKey(ipAddr)) { 
item.setHostName(mapName.get(ipA ddr)); 
} else í 
item.setHostName(MacManaper.getlnstance(this).getDeviceName(item.getDevice())); 
String upperDevice = item.getDevice().toUpperCase(); 
if (upperDevice.equals(" INTEL") || upperDevice.equals("HEWLETT") 
|| upperDevice.equals("DELL") || upperDevice.equals(" ASUS") 
|| upperDevice.equals(" ACER") || upperDevice.equals("TOSHIBA")) í 
Log.d(TAG, "new GetClientNameTask"); 
GetClientNameTask getNameTask = new GetClientNameTask(); 
getNameTask.setFindNameListener(WifiShareActivity.this); 
getNameTask.execute(ipA ddr); 


t 
ClientListAdapter clientAdapter = new ClientListAdapter(this, mClientArray); 
lv wifi client.setAdapter(clientAdapter); 


public static native String nameFromJNl(String ip); 
public static native String unimplementedNameFromJNl(String ip); 
static í 
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System.loadLibrary("jni mix"); 
5 


@Override 
public void onFindName(String info) í 
if (info != null && info.length() > 0) í 
String[] split = info.split("\\|"); 
if (split.length > 1 && split[1].length() > 0) í 
mapName.put(split[0], split[1]); 
; 


145 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 常见 融合 技术 ， 包 括 网 页 集成 〈 资 产 管理 器 、 网 页 视图 、 
简单 浏览 器 ) 、JNI 开 发 NDK 环境 搭建 、 创 建 JNI 接口 、JNI 实现 加 解密 ) 、 局 域 网 开发 (无 
线 网 络 管理 器 、 蓝 牙 技术 ) 。 最 后 设计 了 一 个 实战 项 目 “WIFI 共享 器 ”， 在 该 项 目的 App 编 
码 中 采用 了 本 书 到 目前 为 止 的 主要 后 台 技术 ,实现 了 WIFI 热点 的 共享 和 热点 连接 设备 的 检测 。 
另外 ， 介 绍 了 NetBIOS 协议 的 实际 运用 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 

(1) 学 会 使 用 网 页 视图 集成 网 页 显示 。 

(2) 学 会 实现 JNI 接口 的 编码 与 调用 。 

(3) 学 会 使 用 蓝牙 技术 完成 设备 之 间 的 数据 传输 。 

(4) 学 会 使 用 无 线 网 络 管理 器 进行 WIFI 热点 的 管理 操作 。 





CHEM 第 = 方 开发 包 


手机 App 的 功能 日 益 丰 富 , 除了 Android 系统 自身 不 断 
更 新 换代 ， 更 离 不 开 众多 服务 提供 商 的 开发 包 。 本 章 介 绍 
App 开发 常见 的 第 三 方 开 发 包 , 主要 包括 国内 两 家 主要 的 地 
图 服务 开发 (百度 地 图 和 高 德 地 图 ) 、 全 球 华人 主要 的 两 个 
分 享 渠道 开发 《QQ 分 享 和 微 信 分 享 ) 、 国 内 两 家 主要 的 支 
付 服务 开发 (支付 宝 和 微 信 支付 )、 中 文 世界 主要 的 语音 服 
务 开发 ( 讯 飞 语音 的 语音 识别 和 语音 合成 ) 。 最 后 结合 本 章 
所 学 的 知识 演示 一 个 实战 项 目 “ 仿 滴 滴 打 车 ”的 设计 与 实现 。 





M 
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15.4 地 图 SDK 


地 图 是 人 们 日 常生 活 中 不 可 或 缺 的 工具 ， 手 机 上 与 地 图 有 关 的 功能 也 很 常见 ， 比 如 定位 
自己 在 哪 条 街道 什么 位 置 、 查 查 周 边 有 哪些 好 吃 好 玩 的 地 方 等 。 由 于 地 图 功能 与 用 户 所 在 国家 
密切 相关 ， 因此 Android 系统 自身 并 不 提供 地 图 功能 ，App 需要 接 入 第 三 方 地 图 开发 包 才 能 实 
现 相关 功能 。 国 内 常用 的 地 图 SDK 包括 百度 地 图 和 高 德 地 图 ， 本 节 对 这 两 个 地 图 的 开发 包 分 
别 进 行 介绍 。 


15.1.1 查看 签名 信息 














尽管 现在 App 的 反 破 解 手段 已 经 很 多 了 , 不 过 是 道 高 一 尺 、 麻 高 一 丈 , 各 种 山寨 版 的 App 
仍然 层出不穷 。App 的 包 名 相当 于 人 们 的 身份 证 , 然而 这 个 身份 证 很 容易 被 伪造 ， 如 果 持 有 同 
样 的 身份 证 号 , 我 们 相知 对 方 是 真是 假 ?这 时 就 要 引入 其 他 身份 鉴 伪 标 志 。 对 于 人 类 来 说 ,可 
以 通过 指纹 识别 是 否 为 本 人 。 对 于 App 来 说 ， 也 有 类 似 指纹 的 标志 信息 ， 即 App 的 签名 信息 。 
如 果 黑 客 算 改 了 App 的 安装 包 ， 那 么 签名 信息 必然 发 生变 化 ， 通 过 校 验 签 名 就 能 鉴别 该 App 
WAH. App 有 了 签名 作为 身份 信息 ， 才 允许 在 Android 系统 上 安装 和 运行 。 

应 用 一 般 把 SHA1 作为 签名 信息 。 在 开发 阶段 ，Android Studio 使 用 自 带 的 签名 文件 
debug.keystore 给 App 签名 ; 在 上 线 阶段 ， 开 发 者 提供 自己 的 签名 文件 给 App 做 正式 签名 。 有 
的 第 三 方 SDK〈 如 地 图 类 的 开发 包 ) 需要 开发 者 分 别提 供 开 发 版 的 签名 和 发 布 版 的 签名 ， 以 
此 判断 App 能 否 正 常 使 用 地 图 功能 。 这样 一 来 ,大 家 就 比较 关心 如 何 才能 知晓 自己 的 Android 
Studio 用 的 是 什么 签名 ? 下 面 分 别 介绍 一 下 开发 版 签名 和 发 布 版 签名 的 获取 方法 。 


1. 开发 版 签名 


Android Studio 自 带 的 签名 文件 位 于 用 户 目 录 
的 .android/debug.keystore。 打 开 Android Studio, 3:5* £ 
面 右边 有 一 个 竖 排 的 Gradle 按钮 , 单 击 该 按钮 弹出 当 | ”> Grawesstay Goo 
前 项 目的 概念 结构 窗口 ， 点 开 项 目 名 称 内 部 的 dier 
Tasks/android 目录 ， 发 现 其 下 有 3 个 工具 ， 分 别 是 Mies 
androidDependencies,. signingReport 和 sourceSets, FR 
体 的 目录 结构 如 图 15-1 所 示 。 

这 里 的 signingReport 为 签名 报告 工具 ， 双 击 
signingReport 运行 该 工具 ， 之 后 Android Studio 开始 
查找 并 报告 每 个 模块 的 开发 签名 。 报 告 结果 打印 在 主 
界面 左下 方 的 signingReport 窗口 , 框 起 来 的 SHAT F 
符 串 为 模块 thirdsdk 的 开发 签名 ， 如 图 15-2 所 示 。 




















15-1. Gradle 项 目的 结构 图 
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FurtherStudy [signingReport] 
:thirdsdk:signingReport 
Variant: debugAndroidTest 


Config: debug 


angshen\. androi d debug. keystore 





图 15-2 开发 版 签名 的 查询 结果 


默认 的 调试 签名 文件 通常 不 会 更 改 ， 当 然 也 有 例外 情况 ， 比 如 微 信 平台 SDK 的 演示 工程 
要 求 使 用 demo 工程 自 带 的 签名 文件 。 若 要 更 换 调试 用 的 签名 文件 ， 则 需要 修改 对 应 模块 的 
build.gradle， 即 在 该 编译 文件 的 android 节点 下 补充 签名 配置 ， 表 示 开 发 版 签名 使 用 当前 模块 
目录 下 的 debug.keystore ; 
signingConfigs í 
debug í 
storeFile file("debug.keystore") 


i 
2. 发 布 版 签名 


第 8 章 介 绍 App 发 布 时 提 到 使 用 密 钥 文件 为 App 打包 安装 包 ， 这 个 密 钥 文件 就 是 发 布 版 
的 签名 文件 。 依 次 选择 菜单 Build 一 Generate Signed APK...， 在 弹出 的 窗口 中 选择 待 打包 的 模 
块 ， 进 入 APK 签名 窗口 页 面 ， 如 图 15-3 所 示 。 

这 里 的 test.jks 为 发 布 用 的 签名 文件 ， 若 想 查 看 该 文件 的 签名 信息 ， 则 可 打开 命令 提示 符 
窗口 ， 在 命令 行 输入 keytool -v -list -keystore F:\StudioProjects\testjks， 然 后 回 车 运行 该 命令 ; 
接着 窗口 提示 输入 密 钥 库 口 令 ， 该 口令 为 密 钥 文件 的 密码 ， 输 入 密码 并 回 车 ， 稍 等 一 会 儿 ， 命 
令 行 窗口 会 把 该 密 钥 文件 的 详细 签名 信息 打印 出 来 ， 完 整 的 签名 信息 如 图 15-4 所 示 。 注 意 ， 
框 起 来 的 SHA1 字符 串 为 发 布 版 的 签名 串 。 








^ Cenerate Signed APK [^ 





Key store path: 





Create nex... Choose existing... 


Key store password: 





Key alias 
Key password: (eee 


Rexesber passwords 


menas] WE | osa (aa 











图 15-3 APK 签名 窗口 图 15-4 ”发布 版 签名 的 查询 结果 
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15.1.2 百度 地 图 


百度 地 图 的 开发 网 址 是 http://lbsyun.baidu.com/， 进 入 该 网 站 后 ， 依 次 选择 “开发 ”一 
“Android 开发 ”一 “Android 地 图 SDK” 一 “相关 下 载 ”， 即 可 打开 百度 地 图 的 SDK 下 载 页 
面 。 开 发 者 可 在 此 页 面 选择 “ 自 定义 下 载 ” 或 “一 键 下 载 ”。 当 然 ， 作 为 勤奋 好 学 的 开发 者 ， 
有 必要 了 解 地 图 SDK 的 具体 组 件 ， 这 里 建议 选择 “ 自 定义 下 载 ”， 打 开 的 地 图 组 件 页 面 如 图 
15-5 所 示 。 
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图 15-5 百度 地 图 SDK 的 下 载 页 面 
在 该 页 面 勾 选 需 要 集成 的 组 件 ， 单 击 页 面 左 下 方 的 “开发 包 ” 按 钮 ， 下 载 包含 对 应 组 件 
的 地 图 SDK; 单 击 “ 示 例 人 代码” 按钮 ， 可 下 载 官方 的 demo 工程 源 代码 。 
有 了 地 图 SDK， 还 得 申请 开发 者 账号 和 测试 应 用 账号 ， 才 能 在 测试 应 用 中 正常 使 用 地 图 
功能 。 具 体 的 申请 步 又 如 下 : 
KI 打开 百度 地 图 的 开发 者 平台 网 址 http://developer.baidu.com/， 依 次 选择 “开发 者 中 心 ” 
应 用 管理 ”一 “创建 工程 ” 打开 应 用 创建 页 面 ， 如 图 15-6 所 示 。 























developer. bai du. con/corcc t efspc /creste 









+ 应 用 和 名称: mcr 


WRRAWM: StF 
MODE: LI 








图 15-6 百度 地 图 的 应 用 创建 页 面 


CEO 在 应 用 创建 页 面 填写 应 用 名 称 ， 然 后 单 击 “ 创 建 ”按钮 ， 创 建成 功 后 跳 转 到 应 用 信息 页 
面 ， 如 图 15-7 所 示 。 
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15-7 测试 应 用 的 基本 信息 页 面 


CLI3 记 下 该 页 面 “ 基 本 信息 ”中 的 API Key, JEF, š 





务 ” 链 接 ， 跳 转 到 地 图 服务 页 面 ， 如 图 15-8 所 示 。 


修改 应 用 




















单 击 页 面 左 侧 导航 栏 的 “LBS BR 








图 15-8 ”测试 应 用 的 地 图 服务 页 面 



































CXX04 在 地 图 服务 页 面 选择 Android SDK 应 用 类 型 , 然后 勾 选 需要 启用 的 服务 , 并 在 7 
测试 应 用 的 包 名 和 SHA1 签名 串 ， 视 情况 可 同时 填 入 发 布 版 签名 和 开发 版 签名 。 填 写 完毕 后 单 
交 ” 按 钮 ， 再 回 到 应 用 列表 页 面 ， 一 个 可 用 的 测试 应 用 账号 就 申请 完成 了 ， 如 图 15-9 所 示 。 


下 方 输入 











Rb 
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RL 





lbeyun. bai du. camasi cons: 


我 的 应 用 
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dkcoGBwOQuQudX. 








图 15-9 申请 完成 的 应 用 列表 页 面 
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完成 测试 应 用 的 账号 申请 后 ， 接 下 来 进行 地 图 开发 环境 的 搭建 工作 。 
首先 ， 打 开 AndroidManifestxml， 在 application 节点 下 补充 百度 地 图 的 密 钥 配置 。 其 中 ， 
android:value 字段 值 为 应 用 基本 信息 的 APIKey。 具 体 配置 代码 如 下 : 


<- 百度 地 图 密 钥 -> 

<meta-data 
android:name="com.baidu.Ibsapi.API KEY" 
android:value="vRbVCiHqbhdkcoG8wOQwQvdX" /> 


其 次 , 把 SDK 包 里 的 BaiduLBS_Android.jar 复制 到 模块 的 libs 目录 。 除 jar 文件 外 ,把 其 
R so 库 的 所 有 文件 夹 复制 到 sre/main/jniLibs 目录 下 。 

最 后 ， 把 官方 demo 工程 里 的 com/baidu/mapapi/overlayutil 整个 目录 源码 复制 到 你 的 工程 
中 。 该 目录 的 源码 用 于 POI 搜索 ， 原 本 包含 在 SDK 的 jar 包 中 , 不 过 百度 地 图 SDK3.6 及 以 后 
版 本 不 再 内 置 这 部 分 代码 ， 所 以 需要 开发 者 自行 将 这 块 源码 加 入 工程 中 。 

好 不 容易 搞定 了 地 图 功能 的 账号 申请 与 环境 搭建 ， 终 于 进入 大 家 最 期 待 的 地 图 开发 环节 
了 。 地 图 的 开发 有 很 多 应 用 场景 ， 这 里 选取 几 个 常用 又 相对 简单 的 功能 ， 方 便 读者 快速 上 手 。 
这 些 功 能 包括 显示 地 图 并 定位 、POI 搜索 、 距 离 与 面积 测量 ， 分 别 介绍 如 下 : 


1. 显示 地 图 并 定位 
对 于 地 图 SDK 来 说 ， 最 基础 的 功能 是 显示 当前 城市 的 地 图 。 编 码 需 要 注意 以 下 几 点 : 
CD 在 加 载 页 面 布局 前 要 先 对 SDK 进行 初始 化 操作 , BITE setContentView 方法 之 前 插入 
下 面 这 行 代码 : 
SDKInitializer.initialize(getApplicationContext()); 


(2) 一 开始 要 先 隐藏 地 图 图 层 ， 等 定位 到 当前 城市 后 再 开启 图 层 显示 。 如 果 一 开始 默认 
显示 北京 地 图 ， 就 不 会 直接 显示 当前 城市 的 地 图 了 。 


地 图 相关 类 及 对 应 的 方法 较 多 ， 且 在 不 断 更 新 中 ， 无 法 一 一 列举 ， 读 者 可 参考 百度 地 图 
官网 的 最 新 API 说 明文 档 。 下 面 是 有 关 地 图 显示 与 定位 的 代码 ; 


private MapView mMapView; 

private BaiduMap mMapLayer; 

private LocationClient mLocClient; 

private boolean isFirstLoc — true; / 是 否 首次 定位 
private double m_latitude; 

private double m_longitude; 


private void initLocation() í 
mMapView = (MapView) findViewById(R.id.bmapView); 
mMapView.setVisibility( View.INVISIBLE); // 先 隐藏 地 图 , 待定 位 到 当前 城市 时 再 显示 
mMapLayer = mMapView.getMap(); 
mMapLayer.setOnMapClickListener(this); 
mMapLayer.setMyLocationEnabled(true); / 开启 定位 图 层 


*588* 
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mLocClient = new LocationClient(this); 
mLocClient.registerLocationListener(new MyLocationListenner()); // 设置 定位 监听 器 
LocationClientOption option = new LocationClientOption(); 


option.setOpenGps(true); / 打开 GPS 
option.setCoorType("bd091l"); /1/ 设置 坐标 类 型 
option.setScanSpan(1000); / 设置 定位 的 时 间 间 隔 
option.setIsNeedA ddress(true); // 设置 true 才能 获得 详细 的 地 址 信息 
mLocClient.setLocOption(option); // 设置 定位 参数 

mLocClient.start(); / 开始 定位 


public class MyLocationListenner implements BDLocationListener í 
@Override 
public void onReceiveLocation(BDLocation location) { 
if (location = null | mMapView = null) í // map view 销毁 后 不 再 处 理 新 接收 的 位 置 
Log.d(TAG, "location is null or mMapView is null"); 
return; 

j 

m latitude — location.getLatitude(); 

m longitude = location.getLongitude(); 

String position = String.format(" 当 前 位 置 : %s|%s|%s|%s|%s|%s|%s", 
location.getProvince(), location.getCity(), location.getDistrict(), location.getStreet(), 
location.getStreetNumber(), location.getAddrStr(), location.getTime()); 

loc position.setText(position); 

MyLocationData locData = new MyLocationData.Builder().accuracy(location.getRadius()) 
/ 此 处 设置 开发 者 获取 的 方向 信息 ， 顺 时 针 0 一 360 
-direction(100).latitude(m latitude).longitude(m longitude).build(); 

mMapLayer.setMyLocationData(locData); 

Toast.makeText(MapBaiduA ctivity.this, "isFirstLoc-" + isFirstLoc, 

Toast.LENGTH LONOG).show(); 
if (isFirstLoc) í 
isFirstLoc — false; 
LatLng ll = new LatLng(m latitude, m longitude); 
MapsStatusUpdate update = MapStatusUpdateFactory.newLatLngZoom(ll, 14); 
mMapLayer.animateMapStatus(update); 
mMapView.setVisibilit View. VISIBLE); // 定位 到 当前 城市 时 再 显示 图 层 


public void onReceivePoi(BDLocation poiLocation) í 
; 
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百度 地 图 定位 与 显示 的 效果 如 图 15-10 所 示 。 展 示 的 界面 
是 笔者 所 在 城市 的 地 图 ， 中 央 的 圆 点 为 笔者 当前 所 处 的 位 置 。 


2. POI 搜索 
POI 即 地 图 注 点 ， 是 Point Of Interest 的 缩写 ， 通 过 在 地 


城市 中 搜索 - 开始 下 一 组 数据 
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图 上 标注 地 点 名 称 、 类 别 、 经 度 、 纬 度 等 信息 实现 携带 位 置 y 

信息 的 地 图 标注 功能 。POI 搜索 是 地 图 SDK 的 一 个 重要 功能 ， ESSA 

根据 关键 词 搜索 并 在 地 图 上 显示 周边 地 点 的 查询 结果 ， 是 智 SN 

能 出 行 的 基础 。 A 
POI 搜索 的 详细 代码 行 较 多 ,为 节约 篇 幅 , 这 里 就 不 贴 出 pum : 

来 了 ， 读 者 可 参考 本 书 的 下 载 资 源 。 百 度 地 图 搜索 POI 的 效 pn NA 








果 如 图 15-11 和 图 15-12 所 示 。 其 中 ， 图 15-11 所 示 为 输入 关 
键 词 “公园 ”后 的 查询 结果 ， 点击 其 中 某 个 标注 ， 页 面 下 方 "men 
弹出 小 窗口 提示 该 标注 代表 的 公园 信息 ， 如 图 15-12 所 示 。 81540 百度 地 图 定位 到 当前 城市 
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图 15-11 百度 地 图 的 POI 搜索 结果 图 15-12 点 击 某 个 POI 弹出 标注 信息 


3. 距离 与 面积 测量 


测量 距离 和 测量 面积 是 地 图 SDK 的 一 个 常见 功能 ， 该 功能 除了 在 地 图 上 添加 标注 外 ， 还 
要 用 到 数学 中 的 两 个 公式 。 

其 中 ， 测 距 用 的 是 色 股 定理 〈 商 高 定理 ) 。 色 股 定理 是 一 个 基本 的 几何 定理 : 一 个 直角 
三 角形 ， 两 直角 边 的 平方 和 等 于 斜 边 的 平方 。 如 果 直 角 三 角形 两 直角 边 为 a Mb, RPAN c, 
那么 ate? =c?。 

测 面 积 用 的 是 海伦 公式 ( 秦 九 韶 公 式 ) 。 海 伦 公 式 是 利用 三 角形 的 3 个 边 长 直接 求 三 角形 面 
积 ， 表 达 式 为 : S=Vp@ =-ap=-bD@=-o 。 基 于 海伦 公式 ， 可 以 推导 出 根据 多 边 形 各 边 长 求 多 边 
形 面积 的 公式 ， 即 S = ( (xoyi-xiyo) + (Xiy2-X2y1) 十 … + (Xnyo-Xoyn) )/2。 
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进行 测量 时 ， 还 要 在 地 图 上 添加 标记 ， 如 一 条 线段 的 两 个 项 点、 一 个 多 边 形 的 各 个 顶点 ， 
由 此 衍生 各 种 形状 的 添加 方式 ,调用 MapLayer 对 象 的 addOverlay 方 法 即 可 在 地 图 上 添加 标记 ， 
可 添加 的 标记 形状 说 明 见 表 15-1。 


表 15-1 百度 地 图 的 标记 说 明 




















百度 地 图 的 标记 类 MapLayer 类 的 添加 方法 说 明 
ArcOptions addOverlay 弧 线 
CircleOptions addOverlay 圈 
MarkerOptions addOverlay 图 片 
PolygonOptions addOverlay 多 边 形 
PolylineOptions addOverlay 线段 
TextOptions addOverlay 文本 





弄 懂 了 测量 的 算法 原理 和 在 地 图 上 添加 标记 的 方法 ， 测 距 与 测 面积 的 实现 就 不 难 了 。 为 
节省 篇 幅 ， 这 里 不 再 贴 出 距离 与 面积 测量 的 代码 ， 读 者 可 自行 查看 本 书 下 载 资源 中 的 代码 。 

使 用 百度 地 图 测 距 与 测 面积 的 效果 如 图 15-13 和 图 15-14 所 示 。 其 中 ， 图 15-13 JE T 
林 公 园 与 西湖 的 测 距 结 果 , 可 以 看 到 两 点 之 间距 离 5.9 PK. 再 来 看 面积 测量 的 结果 , 图 15-14 
显示 西湖 公园 的 面积 大 约 是 84 万 平方 米 。 
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图 15-13 百度 地 图 的 距离 测量 结果 


15.1.3 ”高 德 地 图 


mor NRF e 








图 15-14 百度 地 图 的 面积 测量 结果 


高 德 地 图 的 开发 网 址 是 http://Ibs.amap.com/, 进入 该 网 站 后 , 依次 选择 “开发 ”一 “Android 
平台 ”一 “Android 地 图 SDK”， 将 页 面 拉 到 底 ， 单 击 左下 方 的 “相关 下 载 ” 链 接 ， 打 开 下 载 
页 面 ， 如 图 15-15 所 示 。 


单 击 下 载 页 面 的 “ 自 定义 下 载 ” 按 钮 ， 向 下 拉 出 组 件 列表 ， 勾 选 需要 下 载 的 组 件 与 资料 ， 


然后 单 击 “ 下 载 ” 按 钮 开始 下 载 地 图 SDK 与 示例 代码 。 
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15-15 ”高 德 地 图 SDK 的 下 载 页 面 


高 德 地 图 也 需要 申请 开发 者 账号 和 测试 应 用 账 
号 ,使 用 开发 者 账号 登录 后 ， 即 可 在 网 页 右上 角 找到 
“控制 台 ” 链 接 ， 依 次 单 击 “ 控 制 台 ”一 “创建 新 应 
用 ”， 弹 出 “创建 应 用 ”窗口 ， 如 图 15-16 所 示 。 

填写 应 用 名 称 并 选择 应 用 类 型 , 然后 单 击 “ 创 建 ” 
按钮 ， 即 可 看 到 应 用 列表 增加 了 一 条 刚 创建 的 应 用 记 
录 ， 如 图 15-17 所 示 。 








15-17 ”测试 应 用 的 初始 信息 


单 击 应 用 记录 右边 的 “添加 新 Key” 按 钮 ， 弹 出 “为 第 三 方 应 用 添加 Key” 窗 口 ， 在 此 可 
设置 应 用 的 Key AE SHAI 签名 、 包 名 等 信息 ， 如 图 15-18 所 示 。 





图 15-18 “为 第 三 方 应 用 添加 Key” 窗 口 


DEED 





第 三 方 开发 包 第 /5 党 





在 设置 窗口 填写 测试 应 用 的 Key 名 称 ， 选 中 服务 平台 Android 平台 SDK， 并 分 别 填写 发 
布 版 签名 、 调 试 版 签名 〈 开 发 签名 ) 、Package( 包 名 ) ,注意 勾 选 “我 已 阅读 ***”， 然 后 单 
击 “ 提 交 ” 按 钮 完成 设置 操作 。 回 到 应 用 列表 页 面 ， 此 时 测试 应 用 下 面 多 了 一 条 刚 添加 的 Key 
记录 ， 如 图 15-19 所 示 。 记 下 这 里 的 Key 值 ， 后 面 会 用 到 。 











15-19. 测试 应 用 的 键 值 信息 


测试 应 用 账号 申请 完成 ， 继 续 搭 建 高 德 地 图 的 开发 环境 。 
首先 ， 打 开 AndroidManifest.xml, fE application 节点 下 补充 高 德 地 图 的 密 钥 配置 。 其 中 ， 
android:value 字段 值 为 测试 应 用 的 Key 值 。 具 体 配 置 代码 如 下 : 
<- 高 德 地 图 密 钥 --> 
<meta-data 
android:name="com.amap.api.v2.apikey" 
android:value="d2d98282615cb90e78b4be537636647c" /> 


同时 还 要 注册 高 德 地 图 的 定位 服务 ， 具 体 的 服务 注册 代码 如 下 : 
«service android:name="com.amap.api.location.APSService" /> 


其 次 ， 把 SDK 包 里 的 AMap***.jar 复制 到 模块 的 libs 目录 ，JAR 文件 可 能 只 有 一 个 ， 也 
可 能 有 多 个 ， 如 AMap2DMap*** jar, AMapSearch*** jar, AMapLocation*** jar 等 ， 如 此 便 完 
成 了 高 德 地 图 的 开发 环境 搭建 工作 。 

下 面 介绍 高 德 地 图 的 3 个 主要 功能 ， 显 示 地 图 并 定位 、POI 搜索 、 距 离 与 面积 测量 。 


1. 显示 地 图 并 定位 


高 德 地 图 也 要 先 隐藏 地 图 图 层 ， 等 到 定位 到 当前 城市 后 再 开启 图 层 显 示 。 具 体 的 定位 代 
码 如 下 : 


private MapView mMapView; 

private AMap mMapLayer; 

private AMapLocationClient mLocClient; 

private boolean isFirstLoc = true;// 是 否 首次 定位 
private double m latitude; 

private double m longitude; 


private void initLocation(Bundle savedInstanceState) í 


mMapView = (MapView) find ViewById(R.id.amapView); 
mMapView.onCreate(savedInstanceState ); 
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mMapView.setVisibilit(View.INVISIBLE); // 先 隐藏 地 图 ， 待 定位 到 当前 城市 时 再 显示 
if (mMapLayer == null) í 

mMapLayer = mMapView.getMap(); 
; 
mMapLayer.setOnMapClickListener(this); 
mMapLayer.setMyLocationEnabled(true); // 开启 定位 图 层 
mLocClient = new AMapLocationClient(this.getApplicationContext()); 
mLocClient.setLocationListener(new MyLocationListenner()); // 设置 定位 监听 器 
AMapLocationClientOption option = new AMapLocationClientOption(); 
option.setLocationMode(AMapLocationMode.Battery Saving); 
option.setNeedAddress(true); // 设置 true 才能 获得 详细 的 地 址 信息 
mLocClient.setLocationOption(option); / 设置 定位 参数 
mLocClient.startLocation(); // 开始 定位 


public class MyLocationListenner implements AMapLocationListener í 
@Override 
public void onLocationChanged(AMapLocation location) { 
if (location — null | mMapView = null) { // map view 销毁 后 不 再 处 理 新 接收 的 位 置 
Log.d(TAG, "location is null or mMapView is null"); 
return; 
] 
m_latitude = location.getLatitude(); 
m_longitude = location.getLongitude(); 
String position = String.format(" 当 前 位 置 : %s|%s|%s|%s|%s|%s|%s", 
location.getProvince(), location.getCity(), location.getDistrict(), 


location.getStreet(), 
location.getAdCode(), location.getAddress(), location.getTime()); 

loc position.setText(position); 

if (isFirstLoc) í 
isFirstLoc — false; 
LatLng ll = new LatLng(m latitude, m longitude); 
CameraUpdate update = CameraUpdateFactory.newLatLngZoom((ll, 12); 
mMapLayer.moveCamera(update); 
mMapView.setVisibilit( View. VISIBLE); // 定位 到 当前 城市 时 再 显示 图 层 

; 

J 
} 


高 德 地 图 定位 与 显示 的 效果 如 图 15-20 所 示 , 展示 的 界面 是 笔者 所 在 城市 的 地 图 , 笔者 当 
前 所 处 的 位 置 在 地 图 正中 央 。 
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2. POL 搜索 


高 德 地 图 搜索 POI 的 流程 与 百度 地 图 类 似 , 具体 代码 参见 本 书 的 下 载 资源 。 POI 搜索 的 效 
果 如 图 15-21 和 图 15-22 所 示 。 其 中 ， 图 15-21 所 示 为 输入 关键 词 “ 公 园 ” 后 的 查询 结果 ; 点 
击 其 中 某 个 标注 ， 标 注 上 方 弹出 小 窗口 ， 提 示 该 标注 代表 的 公园 信息 ， 如 图 15-22 所 示 。 
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15-20 高 德 地 图 定位 到 当前 城市 15-21 


3. 距离 与 面积 测量 
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高 德 地 图 的 POI 搜 索 结果 图 15-22 ”点 击 某 个 POI 弹出 标注 信息 


在 高 德 地 图 上 添加 标记 也 是 通过 调用 MapLayer 对 象 的 add**#*# 方 法 , 可 添加 的 标记 和 对 应 


的 方法 说 明 见 表 15-2。 


表 15-2 ”高 德 地 图 的 标记 说 阴 











高 德 地 图 的 标记 类 MapLayer 类 的 添加 方法 说 明 
CircleOptions addCircle 
MarkerOptions addMarker 图 片 
PolygonOptions addPolygon 多 边 形 
PolylineOptions addPolyline 线段 
TextOptions addText 文本 














使 用 高 德 地 图 测 距 与 测 面 积 的 效果 如 图 15-23 和 图 15-24 所 示 。 其 中 ， 图 15-23 展示 了 福 














州 火车 站 与 国家 5A 景区 


三 坊 七 埠 的 测 距 结果 ， 可 以 看 到 两 点 之 间距 离 4.0 千 米 。 另 外 ， 再 看 


看 测量 岛屿 面积 的 结果 ， 图 15-24 显示 闽 江 口 琅 岐 岛 的 面积 大 约 是 59 平方 公里 ， 与 官方 公布 
的 岛屿 陆地 面积 55 平方 公里 相差 不 远 。 
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图 15-23 高 德 地 图 的 距离 测量 结果 图 15-24 ”高 德 地 图 的 面积 测量 结果 
15.2 分享 SDK 


社会 化 分 享 指 的 是 用 户 通过 互联 网 这 个 媒介 把 文本 /图 片 /多 媒体 信息 分 享 到 该 用 户 的 交 
际 圈 ， 从 而 加 快 信息 传播 的 行为 。 对 于 App 来 说 ， 网 络 社区 虽 多 ， 但 用 户 量 足 够 大 的 就 那么 
JL, App 的 社会 化 分 享 功能 抓 住 几 个 大 的 圈子 就 够 了 ， 比 如 QQ. mfi QQ 空间 、 微 信 朋 
友 圈 等 。 本 节 介 绍 QQ 分 享 与 微 信 分 享 的 实现 方案 。 


15.2.1 QQ 分享 


QQ 好 友 分 享 与 QQ 空间 分 享 同属 QQ 互联 平台 上 的 QQ 分 享 ， 该 平台 的 网 址 是 
https://connect.qq.com/。 依 次 单 击 平台 首页 的 “文档 资料 ”一 左边 导航 栏 的 “SDK 及 资源 下 载 ” 
一 “SDK 下 载 页 面 ”， 进 入 QQ 分 享 的 SDK 下 载 页 面 。 下 载 页 面 上 的 说 明 资 料 比 较 详细 ， 这 
里 主要 介绍 与 QQ 分 享 相关 的 方法 与 参数 。 

下 面 是 QQ 分 享用 到 的 Tencent 类 的 主要 方法 说 明 。 


createlnstance: 根据 appid 创建 一 个 Tencent 实例 。 

login: QQ 账号 登录 。 该 方法 需 指 定 登 录 回调 监听 器 IUiListener。 

setAccessToken: 设置 入 口令 牌 。 登 录 成 功 后 设置 ， 即 完成 授权 动作 。 

setOpenId: 设置 开放 标识 。 登 录 成 功 后 设置 ， 即 完成 授权 动作 。 

getQQToken: 获取 QQ 登录 授权 的 令 牌 。 分 享 到 腾讯 微 博时 才 需 使 用 该 方法 。 
shareToQQ: 分 享 给 QQ 好 友 。 该 方法 需 指定 分 享 参 数 ， 分 享 参数 的 取 值 说 明 见 表 15-3。 
shareToQzone: 分 享 到 QQ 空间 .。 该 方法 需 指定 分 享 参数 , 分 享 参 数 的 取 值 说 明 见 表 15-3。 
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表 15-3 ”QQ 分 享 的 接口 参数 说 阴 
QQShare 类 的 分 享 参数 说 明 
SHARE TO QQ KEY TYPE 分 享 类 型 。 图 文 分 享 普通 分 享 ) 填 
Tencent.SHARE TO QQ TYPE DEFAULT 














PARAM TARGET URL 分 享 消息 被 点 击 后 的 跳 转 URL 
PARAM TITLE 分 享 的 标题 
PARAM_SUMMARY 分 享 的 消息 摘要 





SHARE TO QQ IMAGE URL | 分 享 图 片 的 URL 或 本 地 路 径 
SHARE TO QQ APP NAME 在 手机 QQ 顶部 的 “返回 ”按钮 文字 后 加 上 应 用 名 。 若 为 空 ， 则 “返回 ” 
按钮 保持 原样 


QQ 分 享 完 毕 后 可 能 收 不 到 回调 事件 ， 这 是 因为 有 的 手机 会 自动 回收 资源 。 要 想 避 免 该 问 
题 ， 得 重 写 Activity 页 面 的 onActivityResult 方法 ， 加 入 Tencent 类 的 onActivityResultData Jy 
法 调用 ， 示 例 代码 如 下 : 
@Override 
protected void onActivityResult(int requestCode, int resultCode, Intent data) { 
Log.d(TAG, "-->onActivityResult " + requestCode +" resultCode-" + resultCode); 
if (requestCode—Constants.REQUEST LOGIN || requestCode==Constants.REQUEST_APPBAR) í 








Tencent.onActivityResultData(requestCode,resultCode,data,ItemTencentAdapter.mLoginListener); 
} else if (requestCode—Constants.REQUEST QQ SHARE || requestCode==Constants. 
REQUEST QZONE SHARE) ( 
Tencent.onActivityResultData(requestCode,resultCode,data,ItemTencentA dapter.mShareListener); 


J 
Super.onActivityResult(requestCode, resultCode, data); 


i 


QQ 分 享 的 效果 如 图 15-25 一 图 15-28 所 示 。 其 中 , 图 15-25 所 示 为 待 分 享 信息 的 标题 与 内 
FLE: 点击 分 享 按钮 弹出 分 享 渠道 窗口 ， 如 图 15-26 所 示 ， 当 前 支持 QQ 好 友 、QQ 空间 、 
腾讯 微 博 3 个 渠道 的 分 享 ; 单 击 QQ 好 友 图 标 跳 转 到 发 送 页 面 ， 如 图 15-27 所 示 ， 可 在 此 选择 
消息 分 享 的 好 友 对 象 ; 选择 分 享 的 对 象 好 友 后 可 在 聊天 消息 窗口 看 到 分 享 内 容 , 如 图 15-28 所 
示 ， 包 含 分 享 的 标题 、 内 容 与 图 片 等 信息 。 
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图 15-25 待 分 享 的 消息 内 容 图 15-26 QQ 分 享 的 渠道 列表 
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选择 好 友 
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BERE $ & à & @ O 
图 15-27 选择 分 享 的 好 友 对 象 图 15-28 分 享 完 成 的 聊天 消息 


15.2.2 REDE 


尽管 微 信 与 QQ 都 是 腾讯 公司 开发 , 不 过 它们 各 自 有 自己 的 开放 平台 。 微 信 开 放 平 台 的 网 
址 是 https://open.weixin.qq.com/， 在 平台 首页 依次 单 击 链 接 “ 资 源 中 心 ”一 左边 导航 栏 “ 资 源 
下 载 ” 一 “Android 资源 下 载 ”， 即 可 在 打开 的 页 面 中 下 载 开发 工具 包 与 范例 代码 。 使 用 范例 
代码 演示 时 ， 注 意 修 改 以 下 3 处 地 方 : 


1. 将 模块 的 开发 签名 文件 设置 为 demo 工程 自 带 的 debug.keystore 


打开 模块 的 编译 文件 build.gradle， 在 该 文件 的 android 节点 下 补充 签名 配置 ， 具体 的 配置 
代码 如 下 : 
signingConfigs { 
debug { 
storeFile file("debug.keystore") 
h 
ih 


2. 将 包 名 改 为 demo 工程 的 包 名 net.sourceforge.simcpux 


除了 AndroidManifest.xml 的 package 节点 值 需要 更 改 外 ， 还 要 修改 build.gradle 里 面 的 包 
名 配置 ， 即 将 applicationld 值 改 为 新 的 包 名 ， 有 具体 的 配置 代码 如 下 : 


defaultConfig í 
applicationld "net.sourceforge.simcpux" 
minSdkVersion 15 
targetSdk Version 25 
versionCode 1 
versionName "1.0" 


i 
3. 在 AndroidManifest.xml 中 注册 微 信 分 享 的 回调 页 面 WXEntryActivity 


WXEntryActivity.java 文件 必须 位 于 “ 包 名 .wxapi” 这 个 包 下面 ， 否 则 无 法 正确 收 到 微 信 
分 享 的 返回 结果 。 同 时 要 在 AndroidManifest.xml 中 注册 该 活动 页 面 ， 具 体 的 注册 代码 如 下 : 
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<activity 
android:name="net.sourceforge.simcpux.wxapi.WXEntryActivity" 
android:configChanges-"keyboardHidden|orientation|screenSize" 
android:exported-"true" 
android:screenOrientation-"portrait" 
android:theme-" (gandroid:style/Theme.Translucent.NoTitleBar" /> 
VA dei kf k E A fe HU) AC Bb Ap cm 8 PR 29 bh f px. E Pe H SI IWXAPI . 
SendMessageToWX.Req 和 WXMediaMessage 三 个 类 。 下 面 是 IWXAPI 的 常用 方法 说 明 。 


e createWXAPI: 创建 一 个 微 信 API 实例 。 当 传 入 的 appid 为 空 时 ， 还 需 调 用 registerApp 
方法 进行 注册 ; 注册 完毕 后 再 传 入 appid， 此 时 获得 的 实例 才 可 进行 后 续 分 享 。 
e registerApp: 注册 指定 的 appid. 
e sendReq: 发 送 分 享 请 求 。 该 方法 的 参数 为 SendMessageToWX.Req 对 象 。 
下 面 是 SendMessageToWX.Req 的 常用 属性 说 明 。 
e transaction: 本 次 请 求 的 流水 。 用 于 标识 每 次 请 求 的 唯一 性 。 
e scene: 本 次 请 求 的 场景 。SendMessageToWX.Req.WXSceneSession 表示 分 享 给 微 信 好 友 ， 


SendMessageToWX.Req.WXSceneTimeline 表示 分 享 到 朋友 图 。 
e message: 本 次 请 求 的 信息 。 该 方法 的 参数 为 WXMediaMessage 对 象 。 


下 面 是 WXMediaMessage 的 常用 属性 说 明 。 


title: 分 享 的 标题 。 

description: 分 享 的 内 容 。 

mediaObject: 分 享 的 媒体 信息 。 媒 体 信息 的 对 象 说 明 见 表 15-4。 
thumbData: 分 享 的 缩 略 图 。 


3154 ” 微 信 分 享 的 媒体 对 象 说 明 














媒体 对 象 类 说 明 
WXTextObject 文本 
WXImageObject 图 片 
WX WebpageObject 图 文 〈 既 有 文本 ， 又 有 图 片 ) 
WXMusicObject 音乐 
WXVideoObject 视频 
WXFileObject 文件 





QQ 分 享 与 微 信和 分享 的 使 用 代码 片段 如 下 : 
public void onltemClick(AdapterView<?> arg0, View argl, int arg2, long arg3) { 
ShareChanels item = mChannelList.get(arg2); 
mHandler.sendEmptyMessageDelayed(0, 1500); 
if (item.channelType = WEIXIN) í 
SendMessageToWX.Req req = new SendMessageToWX.Req(); 
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// transaction 字段 用 于 唯一 标识 一 个 请 求 

req.transaction = "wx share" + System.currentTimeMillis(); 
Teq.message = get WXMessage(); 

req.scene = SendMessageToWX.Req.W XSceneSession; 
mWeixinApi.sendReq(req); 


} else if (item.channelType == CIRCLE) í 


SendMessageToWX.Req req = new SendMessageToWX.Req(); 
req.transaction = "wx share" + System.currentTimeMillis(); 
req.message = getWXMessage(); 

req.scene = SendMessageToWX.Req.W XSceneTimeline; 
mWeixinApi.sendReq(req); 


} else if (item.channelType = QQ) í 


TYPE DEFAULT); 


mShareListener = new ShareQQListener(mContext, item.channelName); 
Bundle params = new Bundle(); 
params.putInt(QQShare.SHARE TO QQ KEY TYPE, QQShare.SHARE TO QQ _ 


params.putString(QQShare.SSHARE TO QQ TITLE, mTitle); 
params.putString(QOShare.SHARE TO QQ SUMMARY, mContent); 
params.putString(QQShare.SHARE TO QQ TARGET URL, mUrl); 
params.putString(QOShare.SSHARE TO QQ IMAGE URL, mlImageUrl); 
params.putString(QQShare.SSHARE TO QQ APP NAME, mContext.getPackageName()); 
mTencent.share ToQQ((Activity) mContext, params, mShareListener); 


} else if (item.channelType = QZONE) { 


mShareListener = new ShareQQListener(mContext, item.channelName); 
ArrayList-String» urlList = new ArrayList-String^(); 

urlList.add(mImageUrl); 

Log.d(TAG, "mImageUrl-" + mImageUrl); 

Bundle params = new Bundle); 
params.putInt(QzoneShare.SHARE TO QZONE KEY TYPE, QzoneShare.SHARE TO ` 


QZONE TYPE IMAGE TEXT); 


params.putString(QzoneShare.SSHARE TO QQ TITLE, mTitle); 
params.putString(QzoneShare.SHARE TO QQ SUMMARY, mContent); 
params.putString(QzoneShare.SHARE TO QQ TARGET URL, mUrl); 
params.putStringArrayList(QzoneShare.SHARE TO QQ IMAGE URL, urlList); 
Log.d(TAG, "begin shareToQzone"); 

mrTencent.share ToQzone(( Activity) mContext, params, mShareListener); 
Log.d(TAG, "end shareToQzone"); 


} else if (item.channelType = WEIBO) í // 腾讯 微 博 分 享 需要 QQ 登录 授权 


mTencent.login((Activity) mContext, "all", mLoginListener); 


private int THUMB SIZE = 150; 
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private WXMediaMessage get WXMessage() í 

WXMediaMessage msg = new WXMediaMessage(); 

if ((TextUtils.isEmpty(mTitle) && TextUtils.isEmpty(mImageUrl)) { // 分 享 文本 消息 
WXTextObject textObj = new WXTextObject(); 
textObj.text — mContent; 
msg.mediaObject = textObj; 
msg.title = mTitle; 
msg.description = mContent; 

} else if (TextUtils.isEmpty(mTitle) && !TextUtils.isEmpty(mImageUrl)) { // 分 享 图 片 消息 
Bitmap bmp = BitmapFactory.decodeFile(mImageUrl); 
WXlImageObject imgObj = new WXImageObject(bmp); 
msg.mediaObject = imgObj: 
Bitmap thumbBmp = Bitmap.createScaledBitmap(bmp, THUMB SIZE, THUMB SIZE, 

true); 

msg.thumbData = CacheUtil.bmpToByteArray(thumbBmp, true); // 设置 缩 略图 

} else if (!TextUtils.isEmpty(mTitle) && !TextUtils.isEmpty(mImageUrl)) { // 分 享 图 文 消 息 
WXWebpageObject webpage = new WXWebpageObject(); 
webpage.webpageUrl = mUrl; 
msg.title = mTitle; 
msg.description = mContent; 
msg.mediaObject = webpage; 
Bitmap bmp = BitmapFactory.decodeFile(mImageUrl); 
Bitmap thumbBmp = Bitmap.createScaledBitmap(bmp, THUMB SIZE, THUMB SIZE, 

true); 

msg.thumbData = CacheUtil.bmpToByteArray(thumbBmp, true); // 设置 缩 略 图 

] 


return msg; 


public static ShareQQListener mShareListener; 
private static class ShareQQListener implements IUiListener í 
private Context context; 
private String cn; 
public ShareQQListener(final Context context, final String channelName) í 
this.context = context; 
this.cn = channelName; 


@Override 
public void onComplete(Object object) { 
Toast.makeText(context, cn + "分 享 完成 :" + object.toString(), Toast. LENGTH. LONG).show(); 
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@Override 
public void onError(UiError error) { 
Toast.makeText(context, cn + "分 享 失 败 :" + error.errorMessage, Toast. LENGTH _LONG).show(); 


ji 


@Override 
public void onCancel() { 
Toast.makeText(context, cn + "分 享 取消 ", Toast. LENGTH_LONG).show(); 


} 
1 
微 信 分 享 的 效果 如 图 15-29 一 图 15-32 所 示 。 其 中 ， 图 15-29 所 示 为 待 分 享 信息 的 标题 与 
内 容 文本 ; 点 击 分 享 按钮 弹出 分 享 渠道 窗口 ， 如 图 15-30 所 示 ， 当 前 支持 包括 微 信 好 友 、 微 信 
朋友 圈 在 内 的 5 个 渠道 分 享 ， 点 击 微 信 好 友 图 标 跳 转 到 好 友 选 择 页 面 ， 如 图 15-31 所 示 ， 可 在 
此 选择 消息 分 享 的 好 友 对 象 ; 选择 分 享 的 对 象 好 友 后 可 在 聊天 消息 窗口 看 到 分 享 内 容 ， 如 图 
15-32 所 示 ， 包 含 分 享 的 标题 、 内 容 与 图 片 等 信息 。 
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图 15-30 微 信 分 享 的 渠道 列表 
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图 15-31 选择 分 享 的 好 友 对 象 图 15-32 分 享 完 成 的 聊天 消息 
15.3 支付 SDK 


第 三 方 支付 指 的 是 第 三 方 平台 与 各 银行 签约 ， 在 买方 与 卖方 之 间 实 现 中 介 担 保 ， 从 而 增 
强 支 付 交易 的 安全 性 。 国 内 常用 的 支付 平台 主要 有 支付 宝 和 微 信 支付 。 其 中 , 支付 宝 的 市 场 份 
额 为 71.5%， 微 信 支 付 的 市 场 份额 为 15.99%。 也 就 是 说 ,这 两 家 垄断 了 7/8 的 支付 市 场 (2015 
年 数据 ) 。 本 节 对 支付 宝 和 微 信 支付 分 别 进行 介绍 。 
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15.3.1 支付 宝 支付 


因为 第 三 方 支付 只 是 一 个 中 介 ， 交 易 流程 要 多 次 确认 ， 所 以 App 若 要 集成 支付 SDK， 需 
要 进行 以 下 处 理 : 

(1) 除了 作为 买方 的 用 户 自己 拥有 支付 账号 ， 开 发 者 还 得 申请 作为 卖方 的 商户 账号 。 

(2) 支付 过 程 中 ， 虽然 允 许 App 直接 与 第 三 方 支付 平台 通信 ,但 是 正常 要 有 自己 的 后 台 
服务 器 ， 由 服务 器 与 第 三 方 平台 进行 通信 。 这 样 做 的 好 处 是 , 一 方面 自己 后 台 掌 握 了 用 户 交 易 
记录 ,做 账 有 依据 , 管理 也 方便 ; 另 一 方面 , 关键 交易 在 服务 器 处 理 , 减少 了 恶意 自 改 的 风险 。 

(3) 为 保证 信息 安全 ， 需 对 关键 数据 进行 加 密 处 理 ， 如 支付 宝 采 用 RSA+BASE64 算法 ， 
微 信 支 付 采用 MDS 算法 。 


支付 宝 的 官方 平台 是 蚂蚁 金 服 开放 平台 , 网 址 是 https://open.alipay.com/, 在 平台 首页 依次 
Toc 文档 中 心 ”一 左边 导航 栏 的 “资源 下 载 ” 一 “开发 工具 包 下 载 一 “App 支付 DEMO&SDK”， 
在 打开 的 页 面 中 点 击 下 载 支付 宝 SDK 及 其 DEMO 工程 。 

另外 ， 申 请 商户 账号 需要 创建 测试 应 用 ， 在 蚂蚁 金 服 平台 登录 成 功 后 ， 依 次 单 击 “ 研 发 
管理 ”一 “创建 应 用 ”， 填 写 应 用 相关 信息 ， 提 交 成 功 后 返回 应 用 列表 页 面 。 然 后 查看 应 用 的 
详情 页 ， 单 击 “ 应 用 环境 ”链接 ， 在 环境 页 面 设置 RSA 密 钥 ， 如 图 15-33 所 示 。 记 下 该 应 用 
的 APPID， 后 面 会 用 到 。 
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图 15-33 支付宝 测试 应 用 的 环境 设置 页 面 
集成 支付 宝 SDK 比较 简单 ， 除 了 必要 的 权限 外 ， 无 须 修改 AndroidManifest.xml，JAR 包 
也 只 要 导入 alipaySdk-*** jar 即 可 。 前 面 商户 账号 的 申请 信息 有 几 个 会 在 代码 中 体现 ， 包 括 商 
户 收 款 账号 〈 开 发 者 的 支付 宝 账号 ) 、 商 户 的 合作 编号 〈 测 试 应 用 的 APPID) 、 商 户 的 RSA 
私 钥 〈 在 应 用 环境 页 面 中 设置 的 RSA 密 钥 )。 
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使 用 支付 宝 SDK 的 交易 流程 大 致 如 下 : 


(1) 按照 指定 格式 封装 好 交易 信息 。 

(2) 对 交易 信息 进行 RSA 加 密 与 URL 编码 。 

(3) 调用 支付 接口 , 传 入 加 密 好 的 信息 串 (这 步 要 另 开 线 程 处 理 , 不 能 放 在 UI 线程 中 ) 。 
(4) 支付 宝 SDK 在 界面 下 方 弹出 支付 窗口 ， 用 户 输入 支付 账号 信息 ， 提 交 支 付 。 

(5) 收 到 支付 完成 的 结果 ， 判 断 支付 状态 是 成 功 还 是 失败 ， 并 做 相应 的 后 续 处 理 。 


具体 的 编码 实现 方面 ,支付 宝 官方 的 DEMO 工程 采用 了 Thread+Handler 的 异步 处 理 模式 ， 
不 过 该 模式 要 把 线程 代码 写 在 Activity 页 面 中 , 不便 管理 与 后 续 维护 ， 因 此 笔者 的 演示 代码 将 
其 改造 为 AsyncTask 异步 任务 处 理 方式 ， 详 细 代码 内 容 参 见 本 书 的 下 载 资源 。 
支付 宝 SDK 的 演示 效果 如 图 15-34 和 图 15-35 所 示 。 其 中 ， 图 15-34 所 示 为 待 付费 的 商品 
详情 ; 点击 “支付 宝 支 付 ”按钮 ， 页 面 下 方 弹 出 对 话 框 ， 等 待 用 户 确认 付款 ， 如 图 15-35 所 示 。 
Thirdsdk x E 付款 详情 
大 白 免 奶 糖 


O163 com 


交通 银行 信用 卡 sg) 


商品 名 称 : == 
ji g 0.01 元 


商品 描述 : 中 国 驰名 商标 ， 畅 销 全 球 一 百 多 
个 国家 和 地 区 。 


商品 价格 : 0.01 元 


ETE 确认 付款 


图 15-34 ” 待 支付 的 商品 信息 图 15-35 支付 宝 的 付款 弹 窗 
15.3.2” 微 信 支 付 


微 信 支 付 的 官方 平台 是 微 信 开 放 平 台 ， 网 址 是 https://open.weixin.qq.com/。 在 平台 首页 依 
次 单 击 “ 资 源 中 心 ”一 左边 导航 栏 的 “资源 下 载 ”一 “Android 资源 下 载 ”， 即 可 在 打开 的 页 
面 中 下 载 开发 工具 包 与 范例 代码 ， 注 意 这 里 的 开发 包 libammsdk.jar 同时 集成 了 微 信 分 享 与 微 
信 支 付 的 SDK。 

使 用 微 信 支付 也 需 先 申 请 测试 应 用 ， 在 微 信 开 放 平 台 登 录 成 功 后 ， 依 次 单 击 链 接 “ 管 理 
中 心 ” 一 “创建 移动 应 用 ”， 填 写 应 用 相关 信息 ， 提 交 成 功 后 返回 应 用 列表 页 面 。 然 后 查看 应 
的 详情 页 , 在 接口 信息 栏目 中 发 现 默认 已 获得 微 信 分 享 的 权限 ， 而 微 信 支 付 权限 需要 另外 申 
请 开通 ， 如 图 15-36 所 示 。 

因为 个 人 开发 者 无 法 申请 微 信 支 付 功能 ， 所 示 只 能 使 用 官方 DEMO 工程 里 的 测试 账号 进 
行 演示 。 由 于 微 信 支 付 与 微 信 分 享 在 同一 个 开发 包 中 ,因此 集成 步骤 与 微 信 分 享 大 致 相同 ， 额 
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图 15-36” 微 信 平台 测试 应 用 的 接口 信息 页 面 


(1) 支付 结果 页 面 的 代码 WXPayEntryActivity.java 必须 放 在 “ 包 名 .wxapi” 这 个 包 下 面 。 
另外 ，AndroidManifest.xml 也 要 补充 注册 ，activity 节点 的 注册 配置 举例 如 下 : 
<- 微 信 支 付 回 调 页 面 --> 
<activity 
android:name="net.sourceforge.simcpux.wxapi. WXPayEntryActivity" 
android:exported-"true" 
android:launchMode-"singleTop" > 
«activity» 
C2) 确保 测试 设备 安装 了 微 信 , 并 且 已 有 默认 登录 的 微 信 账 号 。 如 果 设 备 上 没有 安装 微 信 ， 
那么 在 调用 微 信 支付 时 会 报错 Failed to find provider info for com.tencent.mm.sdk.plugin.provider.. 
使 用 微 信 支 付 的 交易 流程 大 致 如 下 : 
(1) 使 用 开发 者 申请 到 的 APP. ID 和 APP. SECRET 向 微 信 平台 请 求 获取 入 口令 牌 。 
COD 封装 订单 信息 〈 使 用 开发 者 申请 到 的 PARTNER_ID 和 PARTNER_KEY) ， 并 对 订 
单 信息 进行 MD5 摘要 处 理 。 
(3) 把 加 密 后 的 订单 与 入 口令 牌 发 给 微 信 平 台 ， 生 成 预支 付 订 单 ， 返 回 预付 订单 编号 。 
(4) 重新 封装 订单 信息 ， 加 上 预付 订单 编号 ， 向 微 信 平 台 发 起 支付 交易 。 
(5) 微 信 SDK 跳 到 微 信 支 付 页 面 ， 用 户 输入 支付 账号 信息 ， 提 交 支 付 。 
(6) 支付 完成 ， 回 到 支付 结果 页 面 ， 根 据 处 理 结果 进行 回调 操作 。 
编码 方面 ， 微 信 支 付 与 支付 宝 一 样 建议 把 支付 操作 交 给 商户 的 后 台 服 务 器 运行 ， 不 要 由 
App 直接 与 支付 平台 进行 付款 交易 , 演示 工程 里 的 测试 代码 只 是 为 了 说 明 交 互 的 流程 , 不 可 作 
为 正式 支付 应 用 。 
微 信 支 付 SDK 的 演示 效果 如 图 15-37 和 图 15-38 所 示 。 其 中 ， 图 15-37 所 示 为 待 付 费 的 
商品 详情 ; 点 击 “ 微 信 支 付 ”按钮 后 ， 跳 转 到 微 信 支 付 的 交易 页 面 ， 等 待 用 户 确 认 付款 ， 如 图 
15-38 所 示 。 
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图 15-37 待 支付 的 商品 信息 图 15-38 ” 微 信 支付 的 付款 页 面 
15.4 语音 SDK 


如 今 ， 越 来 越 多 App 用 到 了 语音 播报 功能 ， 如 地 图 导航 、 天 气 预报 、 文 字 阅 读 、 口 语 训 
练 等 。 语 音 技术 主要 分 为 两 块 ， 一 块 是 语音 转 文字 ， 即 语音 识别 ; 另 一 块 是 文字 转 语音 ， 即 语 
音 合成 。 国 内 的 语音 服务 提供 商 主 要 有 两 家 : 讯 飞 语音 和 百度 语音 。 本 节 主要 介绍 讯 飞 语音 的 
语音 识别 和 语音 合成 功能 。 


15.4.4 语音 识别 


讯 飞 语 音 的 开放 平台 网 址 是 http:/www.xfyun.cn/。 在 平台 首页 单 击 “SDK 下 载 ” 链 接 ， 
在 下 载 页 面 选择 服务 (语音 听写 和 在 线 语音 合成 ) 、 平 台 〈 选 择 Android) 、 选 择 应 用 (一 开 
始 要 创建 新 应 用 ) ， 然 后 单 击 “ 下 载 SDK” 按 钮 ， 等 待 下 载 开发 包 。 

注意 讯 飞 语音 在 下 载 SDK 前 要 先 创建 应 用 ， 不 妨 把 应 用 创建 操作 提 到 前 面 来 。 开 发 者 在 
讯 飞 开放 平台 注册 并 成 功 登 录 后 ， 依 次 单 击 链接 “控制 台 ” 一 左边 导航 栏 的 “创建 新 应 用 ”， 
打开 应 用 创建 页 面 ， 如 图 15-39 所 示 。 


KARES raes- eem. m oE mno em 








图 15-39 讯 飞 语音 的 应 用 创建 页 面 
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填写 各 项 应 用 信息 ， 并 勾 选 “我 已 阅读 并 接受 ***”， 然 后 单 击 “ 提 交 ” 按 钮 ， 回 到 应 用 
信息 页 面 ， 如 图 15-40 所 示 。 
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| D) 我 的 应 用 
后 协作 应 用 


您 还 未 开通 任何 服务 立即 开通 





图 15-40 ”测试 应 用 的 初始 信息 页 面 


应 用 刚 创 建 完 默认 未 开通 任何 服务 ， 因 此 需要 单 击 应 用 页 面 上 的 “立即 开通 ”链接 ， 弹 
出 选择 开通 业务 窗口 ， 如 图 15-41 所 示 。 

首先 勾 选 “语音 听写 ”， 单 击 “ 确 定 ” 按 钮 开通 语音 听写 服务 。 因 为 每 次 只 能 开通 一 项 
服务 ， 所 以 回 到 应 用 信息 页 面 后 ， 单 击 “ 开 通 更 多 服务 ”链接 ， 再 次 打开 业务 开通 窗口 ， 然 后 
勾 选 “在 线 语音 合成 ”， 并 单 击 “ 确 定 ” 按 钮 开通 语音 合成 服务 ， 如 图 15-42 所 示 。 
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图 15-41 开通 语音 识别 服务 图 15-42 开通 语音 合成 服务 


语音 听写 和 语音 合成 服务 都 申请 开通 后 ， 回 到 应 用 信息 页 面 ， 即 可 看 到 该 测试 应 用 的 已 
开通 服务 列表 已 包含 这 两 项 ， 如 图 15-43 所 示 。 同 时 记 下 测试 应 用 的 Appid， 后 面 会 用 到 。 
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图 15-43 开通 服务 后 的 应 用 信息 页 面 


CD 将 Msc.jar、Sunflower.jar 导入 libs 目录 , 将 libmsc.so 整个 目录 导入 sre/main/jniLibs, 
(注意 这 些 文件 必须 来 自 对 应 的 SDK， 如 果 用 别 的 SDK， 运 行 就 会 报错 “用 户 校 验 失败 ”) 


* 607 * 
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(2) 自 定义 一 个 Application 类 ， 在 onCreate 函数 中 加 入 以 下 代码 ， 注 意 appid 值 为 创建 


测试 应 用 时 分 配 到 的 Appid: 


SpeechUtility.createUtility(MainApplication.this, "appid=58561727"); 
(3) 在 AndroidManifest.xml 中 加 入 必要 的 权限 和 自 定 义 的 Application 类 。 
(4) 如 果 使 用 了 RecognizerDialog 控件 ， 就 要 把 DEMO TË assets 目录 下 的 文件 原样 复 


制 过 来 。 


(5) 在 混淆 打包 时 需要 添加 -keep class com.iflytek.** {f*;}， 避 免 混 淆 导致 SDK 不 可 用 。 
讯 飞 SDK 的 语音 识别 功能 主要 通过 SpeechRecognizer 类 实现 ， 看 以 下 常用 方法 。 


e createRecognizer: 创建 语音 识别 对 象 。 
e setParameter: 设置 语音 识别 的 参数 。 语 音 识 别 的 参数 说 明 见 表 15-5. 


R155 语音 识别 的 参数 说 明 


SpeechConstant 类 的 识别 参数 | 说 明 

















ENGINE TYPE 设置 听写 引擎 。TYPE_LOCAL 表示 本 地 ，TYPE_CLOUD 表示 云端 ， 
TYPE_MIX 表示 混合 

RESULT_TYPE 设置 返回 结果 格式 。 比 如 json 表示 json 格式 

LANGUAGE 设置 语言 。zh_cn 表示 中 文 ，en_us 表示 英文 

ACCENT 设置 方言 。mandarin 表示 普通 话 ，cantonese 表示 粤语 ，henanese 表示 河南 话 

VAD_BOS 设置 静音 超时 时 间 ， 即 用 户 多 长 时 间 不 说 话 就 当 作 超时 处 理 

VAD_EOS 设置 静音 检测 时 间 , 即 用 户 停止 说 话 多 长 时 间 内 就 认为 不 再 输入 ,自动 停止 
录音 

ASR PTT 设置 标点 符号 。0 表示 返回 结果 无 标点 ，1 表示 返回 结果 有 标点 





AUDIO. FORMAT 
ASR. AUDIO PATH 
AUDIO SOURCE 


ASR SOURCE PATH 


设置 音频 的 保存 格式 

设置 音频 的 保存 路 径 

设置 音频 的 来 源 。-1 表示 音频 流 ， 与 writeAudio 配合 使 用 ，-2 表示 外 部 文 
件 ， 同 时 设置 ASR_SOURCE PATH 指定 文件 路 径 

设置 外 部 音频 文件 的 路 径 


e startListening: 开始 监听 语音 。 参数 为 RecognizerListener 对 象 ， 该 对 象 需要 重 写 以 下 方法 。 


> onBeginOfSpeech: 内 部 录音 机 已 准备 好 ， 用 户 可 以 开始 语音 输入 。 
> onError: 错误 码 10118 ( 您 没有 说 话 )， 可 能 是 录音 机 权限 被 禁 ， 需 要 提示 用 户 打 开 应 用 


的 录音 权限 。 


> onEndOfSpeech: 检测 到 了 语音 的 尾 端点 ， 已 经 进入 识别 过 程 ， 不 再 接收 语音 输入 。 
> onResult: 识别 结束 ， 返 回 结果 囊 。 
> onVolumeChanged: 语音 输入 过 程 中 的 音量 大 小 变化 。 
> onEvent 事件 处 理 ， 一 般 是 业务 出 错 等 异常 。 
e stopListening: 结束 监听 语音 。 
e writeAudio: 把 指定 的 音频 流 作为 语音 输入 。 
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e cancel: 取消 监听 。 

e destroy: 回收 语音 识别 对 象 。 

语音 识别 的 演示 效果 如 图 15-44 和 图 15-45 所 示 。 其 中 ， 图 15-44 所 示 为 点 击 “ 开 始 ” 按 
钮 后 ， 测 试 App 正在 倾听 用 户 朗 读 时 的 界面 ;朗读 完毕 ， 语 音 SDK 对 音频 流 进行 识别 处 理 ， 
并 把 语音 识别 后 的 文本 内 容 显 示 在 页 面 上 ， 如 图 15-45 所 示 。 





讯 飞 语音 识别 示例 GE 
ERRUZ, MINGA, ESTEE. 
B. 更 上 一 层 楼 。 








ms 停止 取消 
Loos 
15-44 测试 App 正在 倾听 用 户 说 话 图 15-45 ”测试 App 显示 语音 识别 的 文本 


1542 ”语音 合 
语音 合成 和 语音 识别 功能 在 同一 个 开发 包 中 ， 只 需 一 次 集成 ， 无 须 重复 。 
i K SDK 的 语音 合成 功能 主要 通过 SpeechSynthesizer 类 实现 ， 有 以 下 常用 方法 。 
e createSynthesizer: 创建 语音 合成 对 象 。 
e setParameter: 设置 语音 合成 的 参数 。 语 音 合成 的 参数 说 明 见 表 15-6。 
表 15-6 语音 合成 的 参数 说 明 
SpeechConstant 类 的 合成 参数 | 说 明 

















ENGINE TYPE 设置 合成 引擎 。TYPE LOCAL 表示 本 地 ，TYPE_CLOUD 表示 云端 ， 
TYPE_MIX 表示 混合 

VOICE NAME 设置 朗读 者 。 默 认 xiaoyan 〈 女 青年 ， 普 通话 ) 

SPEED 设置 朗读 的 语 速 ， 取 值 0 一 100 

PITCH 设置 朗读 的 音调 ， 取 值 0 一 100 

VOLUME 设置 朗读 的 音量 ， 取 值 0 一 100 

STREAM TYPE 设置 音频 流 类 型 。 默 认 是 3， 表 示 音 乐 





KEY REQUEST FOCUS 
AUDIO FORMAT 
TTS AUDIO PATH 


设置 是 否 在 播放 合成 音频 时 打 断 音乐 播放 ， 默 认为 tue 
设置 音频 的 保存 格式 
设置 音频 的 保存 路 径 


e startSpeaking: 开始 语音 朗读 。 参 数 为 SynthesizerListener 对 象 ， 该 对 象 需 重 写 以 下 方法 。 
> onSpeakBegin: 朗读 开始 。 
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> onSpeakPaused: 朗读 暂停 。 

> onSpeakResumed: 朗读 恢复 。 

> onBufferProgress: 合成 进度 变化 。 

» onSpeakProgress: 朗读 进度 变化 。 

> onCompleted: 朗读 完成 。 

> onEvent 事件 处 理 ， 一 般 是 业务 出 错 等 异常 。 
e synthesizeToUri: 只 保存 音频 不 进行 播放 ， 调 用 该 接口 就 不 能 调用 startSpeaking。 第 一 个 参 
数 是 要 合成 的 文本 ， 第 二 个 参数 是 要 保存 的 音频 全 路 径 ， 第 三 个 参数 是 SynthesizerListener 
回调 接口 。 
pauseSpeaking: 暂停 朗读 。 
resumeSpeaking: 恢复 朗读 。 
stopSpeaking: 停止 朗读 。 
destroy: 回收 语音 合成 对 象 。 

语音 合成 的 演示 效果 如 图 15-46 和 图 15-47 所 示 。 其 中 ， 图 15-46 所 示 为 选择 发 音 人 的 对 
话 框 ， 可 以 看 到 讯 飞 语音 提供 了 中 文 、 英 文 以 及 汉语 的 常见 方言 ,还 是 很 丰富 动听 的 ; 接着 点 
击 “ 开 始 合成 ”按钮 ， 语 音 SDK 对 测试 诗歌 的 文本 进行 语音 合成 ， 并 播放 合成 后 的 音频 流 ， 
如 图 15-47 所 示 。 


CHAT ATA 
JCR. bat. HH Fue a NM 
9-8. chi. MR 
i-i. sis 
3-9. 英语 
1-2, FSB 


小 研 - 女 青 、 中 英 、 营 通话 
小 形 - 女 青 、 中 英 、 曾 通话 
小 妖 - 男 青 、 中 英 、 普 通话 
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15-46 选择 发 音 人 的 弹 窗 页 面 图 15-47 正在 播放 合成 的 语音 


15.5 KRMH: DIT 


这 几 年 分 享 经 济 如 火 如 茶 ， 从 阿姨 外 卖 到 滴 滴 打 车 ， 都 离 不 开 新 技术 、 新 思想 的 实践 。 
特别 是 打车 App， 大 家 或 多 或 少 都 用 过 ， 看 起 来 很 方便 ,可 是 背后 的 技术 支持 着 实 不 简单 。 读 
者 是 否 想 过 自己 实现 一 个 类 似 的 打车 App 呢 ? 现在 就 让 我 们 一 步 一 个 脚印 ， 开 始 着 手 吧 ! 就 
算 没 法 做 出 真正 可 用 的 打车 App， 也 要 鼓 的 一 个 演示 用 的 “ 噶 哄 打车 ”。 





aD 
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15.5.1 设计 思 


滴 滴 打 车 的 用 户 界面 主要 是 一 幅 地 图 配 上 相关 的 打车 信息 ， 打 车 的 具体 流程 不 外 乎 是 : 
用 户 开始 打车 一 司机 接 单一 司机 开 到 出 发 地 , 用 户 上 车 一 司机 开 到 目的 地 , 用 户 下 车 一 用 户 付 
款 行程 结束 。 这 里 为 了 突出 本 章 的 知识 点 ， 依 然 是 化 繁 为 简 ， 把 不 怎么 相关 的 控件 元 素 去 掉 ， 
形成 山寨 后 的 效果 , 如 图 15-48 和 图 15-49 所 示 。 其 中 , 图 15-48 所 示 为 打车 App 的 初始 页 面 ， 
图 15-49 所 示 为 行程 结束 后 的 评价 页 面 。 

惯例 还 是 “大 家 来 找茬 ”， 看 看 这 个 “ 噶 哄 打车 ”用 到 了 本 章 的 哪些 知识 点 ， 想 必 读 者 
早已 轻车熟路 全 部 找 出 来 了 。 

(1) 地 图 SDK: 主 界面 上 都 是 地 图 , 还 得 通过 地 图 显示 用 户 当 前 位 置 和 快车 的 行车 路 线 。 

(2) 语音 SDK: 每 当 遇 到 一 个 需要 提醒 司机 、 用 户 的 事件 或 路 况 信息 ， 比 如 “快车 已 经 
到 达 ”“ 前 方 五 十 米 右 转 ” 等 ， 都 会 响起 一 阵 悦 耳 的 女声 播报 。 


食 食 食 


sate 


eg 


QQ 好友 oSm MRSA 





图 15-48 打车 App 的 初始 页 面 图 15-49 行程 结束 后 的 评价 页 面 
G) 支付 SDK: 行程 结束 ， 用 户 通 过 支付 宝 或 微 信 支 付 ， 把 打车 费 付 款 给 打车 平台 ， 由 
打车 平台 向 司机 分 成 。 
(D 分 享 SDK: 体验 到 快车 的 方便 快捷 ， 小 伙伴 们 想 不 想 分 享 给 好 友 呢 ?分 享 成 功 有 红 
f. 


真实 的 打车 App 还 会 用 到 更 多 第 三 方 开发 包 ， 比 如 消息 推送 SDK. til 2 Pr SDK 等 。 不 
过 ， 实 战 项 目的 “ 哄 噶 打车 ” 仅 用 于 学 习 演示 ， 能 熟练 运用 上 面 4 个 SDK 已 经 足够 了 。 
15.5.0 ”小 知识 : 评分 条 RatingBar 

在 服务 行业 中 ， 商 家 信誉 是 一 个 很 重要 的 指标 ， 信 誉 好 的 商户 ， 生 意 自 然 越 来 越 好 。 如 
何 评价 一 个 商户 的 信誉 等 级 呢 ? 这 依赖 于 消费 者 每 次 光顾 后 的 星 级 评价 。 无 论 是 在 淘宝 购物 ， 


还 是 使 用 滴 滴 打 车 ， 订 单 结束 了 都 会 提示 用 户 进行 评价 ， 此 时 用 到 的 评价 控件 为 评分 条 
RatingBar。 
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RatingBar 其 实 是 拖 动 条 SeekBar 的 升级 版 ， 不 同 之 处 在 于 把 进度 标记 换 成 了 五 角 星 。 
RatingBar 除了 拥有 SeekBar 的 所 有 方法 ， 还 新 增 了 5 个 与 评分 相关 的 方法 ， 新 增 的 方法 与 属 
性 说 明 见 表 15-7。 


表 15-7 RatingBar 的 新 增 方法 与 属性 说 明 
XML 的 新 增 

















属性 RatingBar 的 新 增 方法 说 明 
isIndicator | setlsIndicator 是 否 作为 指示 器 。 如 果 是 指示 器 ， 就 不 可 通过 触摸 修改 评级 
numStars setNumStars 设置 星星 的 个 数 
rating setRating 设置 初始 评价 等 级 
stepSize setStepSize 设置 每 次 增 减 的 大 小 。 默 认为 总 数 的 十 分 之 一 ， 比 如 星星 总 数 
为 5S， 默 认 值 为 0.5 
X setOnRatingBarChangeListener | 设置 评分 监听 器 。 








需 实现 接口 OnRatingBarChangeListener 的 onRatingChanged 方 法 


另外 ，RatingBar 提供 了 3 种 星星 样式 ， 用 于 不 同业 务 场景 时 的 评级 展示 。 评 分 条 的 样式 
说 明 见 表 15-8。 


表 15-8 评分 条 的 样式 说 明 














评分 条 style 属性 的 风格 星星 的 规格 大 小 默认 能 否 触摸 改变 评级 
?android:attr/ratingBarStyle K, ERA 能 

?android:attr/rating BarStyleIndicator 中 不 能 
?android:attr/ratingBBarStyleSmall 小 不 能 





尽管 RatingBar 提供 了 3 种 星星 样式 ， 不 过 是 换 汤 不 换 药 ， 评 分 条 的 星星 外 观 仍然 不 尽 如 
人 意 。 如 果 想 定制 星星 的 颜色 与 大 小 ， 就 得 自 定义 一 个 层次 图 形 描述 文件 ， 然 后 把 RatingBar 
的 progressDrawable 属性 设置 为 该 层次 图 形 。 下 面 是 自 定 义 层 次 图 形 XML 文件 定义 代码 : 


<layer-list xmlns:android="http://schemas.android.com/apk/res/android" > 
<item 
android:id="@+android:id/background" 
android:drawable="@drawable/star_ background" 
</item> 
<item 
android:id="(@+android:id/secondaryProgress" 
android:drawable="@drawable/star_background"> 
</item> 
<item 
android:id="(@+android:id/progress" 
android:drawable-"(g)drawable/star foreground" 
</item> 
</layer-list> 
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下 面 是 使 用 RatingBar 的 代码 : 


public class RatingBarActivity extends AppCompatActivity implements 
OnCheckedChangeListener, OnRatingBarChangeL istener í 
private CheckBox ck whole; 
private RatingBar rb. score; 
private TextView tv rating; 


@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity rating bar); 
ck whole = (CheckBox) findViewById(R.id.ck whole); 
1b score = (RatingBar) findViewById(R.id.rb score); 
tv rating = (TextView) find ViewById(R.id.tv rating); 
ck whole.setOnCheckedChangeListener(this); 
rb score.setOnRatingBarChangeL istener(this); 


@Override 
public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { 
if (buttonView.getId() — R.id.ck whole) í 
rb score.setStepSize(ck whole.isChecked()?1:rb score.getNumStars()/10.0f); 


@Override 

public void onRatingChanged(RatingBar ratingBar, float rating, boolean fromUser) { 
String desc = String.format(" 当 前 选中 的 是 %s 颗 星 ", CacheUtil.formatDecimal(rating, 1)); 
tv_rating.setText(desc); 


j 
评分 条 的 演示 效果 如 图 15-50 和 图 15-51 所 示 。 图 15-50 所 示 为 选择 两 颗 星 时 的 效果 图 。 
图 15-51 所 示 为 选择 3 颗 半 星 时 的 效果 图 。 

















只 可 选择 整 颗 星 只 可 选择 整 颗 星 
当前 选中 的 是 2.0 颗 星 当前 选中 的 是 3.5 颗 星 








图 15-50 ”选择 两 颗 星 时 的 效果 图 15-51 选择 3 颗 半 星 时 的 效果 图 
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15.5.8 ”代码 示例 


(1) 在 libs H3&5 src/main/jniLibs 目录 下 正确 放置 相关 的 SDK 文件 。 


(2) AndroidManifest.xml 注 意 声 明 相 关 权 限 ， 并 注册 地 图 APPKEY 和 相应 的 activity 和 service。 


(3) 注意 地 图 服务 与 语音 服务 的 初始 化 操作 。 
(4) 使 用 真 机 测试 体验 效果 更 佳 。 


其 余 编 码 没什么 难点 了 ， 赶 紧 把 “ 哮 噶 打车 ”安装 到 手机 上 ， 试 着 完整 运行 一 遍 ， 看 看 
是 什么 感觉 。 或 者 先 看 笔者 这 里 的 测试 效果 图 ， 一 点 都 不 难 ， 你 也 可 以 的 。 一 开始 打开 测试 
App, 填写 出 发 地 与 目的 地 , 然后 点 击 “ 开 始 叫 车 ”按钮 ，App 发 布 打车 请 求 ， 并 语音 播报 “等 
待 司 机 接 单 ”， 如 图 15-52 所 示 。 司 机 接 单 后 ，App 语音 播报 “司机 马上 过 来 ”， 因 为 截图 体 

















现 不 了 声音 ， 所 以 页 面 下 方 另外 加 了 一 排 文字 显示 语音 播报 的 内 容 ， 如 图 15-53 所 示 。 


快车 到 达 用 户 位 置 后 ， 小 车 图 标 与 用 户 圆 点 重合 ， 同 时 App 语音 播报 “快车 已 经 到 达 ， 


请 上 车 ”， 如 图 15-54 所 示 。 然 后 用 户 上 车 ， 司 机 一 路 开 向 目的 地 ，App 语音 播报 “已 经 到 
目的 地 ， 欢 迎 下 次 再 来 乘 车 ”， 同 时 下 方 按钮 的 文字 变 为 “支付 车 费 ”， 如 图 15-55 所 示 。 
Thirdsdk 
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图 15-52 等 待 司机 接 单 时 的 界面 。 图 15-53 司机 马上 过 来 的 界面 。 图 15-54 快车 过 来 接客 时 的 界面 
用 户 点 击 “ 支 付 车 费 ” 按 钮 ， 页 面 下 方 弹出 付款 对 话 框 ， 如 图 15-56 所 示 。 确 认 付款 信息 





务 打 分 ， 也 可 将 打车 信息 分 享 给 好 友 ， 如 图 15-57 所 示 。 


.614 。 


正确 无 误 后 ， 点 击 “ 确 认 付款 ”按钮 完成 支付 操作 ， 然 后 跳 到 评价 页 面 ， 用 户 可 在 此 给 快车 服 





第 三 方 开发 包 第 15 3E 





damen 
| » 行程 结束 ， 请 您 进行 评价 
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图 15-55 打车 行程 结束 时 的 界面 ”图 15-56 支付 车 费 的 付款 对 话 框 图 15-57 评价 完成 时 的 页 面 
15.6 小 结 


本 章 主要 介绍 了 App 开发 用 到 的 常见 第 三 方 开 发 包 ， 包括 地 图 SDK (查看 签名 信息 、 百 
度 地 图 、 高 德 地 图 ) 、 分 享 SDK (QQ 分 享 、 微 信 分 享 ) 、 支 付 SDK (支付 宝 、 微 信 支 付 ) 、 
语音 SDK (语音 识别 、 语 音 合成 ) 。 最 后 设计 了 一 个 实战 项 目 “ 仿 滴 滴 打 车 ”， 在 该 项 目的 
App 编码 中 采用 了 本 章 讲述 的 4 种 开发 包 的 代表 技术 。 另 外 ， 介 绍 了 如 何 使 用 评分 条 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 

(1) 学 会 使 用 地 图 SDK 进行 定位 、 搜 索 、 测 量 等 操作 。 

(2) 学 会 使 用 分 享 SDK 把 消息 内 容 分 享 到 QQ 与 微 信 。 

(3) 初步 了 解 支付 的 交易 流程 ， 并 学 会 使 用 支付 SDK 演示 支付 缴费 功能 。 

(4) 学 会 使 用 语音 SDK 完成 语音 的 识别 和 语音 的 合成 。 








"EIE tenkt 


本 章 介 绍 App 开发 常见 的 性 能 优化 技术 ， 主 要 包括 通 
过 优化 布局 文件 实现 页 面 风格 的 统一 、 通 过 检测 手段 和 预防 
措施 处 理 内 存 泄 漏 的 问题 、 运 用 线程 池 技 术 对 线程 资源 进行 
有 效 管 理 、 通 过 监测 当前 电量 与 屏幕 事件 开启 省 电 模式 ， 最 
后 结合 本 章 所 学 的 知识 演示 一 个 实战 项 目 “ 图 片 缓存 框架 ” 
的 设计 与 实现 。 
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16.1 布局 文件 优化 


Android 的 页 面 布 局 千变万化 ， 但 对 某 个 具体 的 App 来 说 ,往往 要 求 有 统一 的 风格 ， 比 如 
统一 的 导航 栏 、 统 一 的 竖 屏 布局 与 横 屏 布局 、 统 一 的 窗口 主题 等 , 这 种 统一 风格 就 像 学 生 的 校 
服 和 白领 的 制服 。 本 节 介 绍 风格 统一 的 几 种 方式 , 包括 增加 公共 布局 减少 重复 布局 、 使 用 占 位 
视图 自 适 应 调整 屏幕 布局 、 自 定义 窗口 主题 等 内 容 。 


16.1.1 减少 重复 布局 


第 7 章 介绍 工具 栏 Toolbar 的 时 候 提 到 在 布局 文件 中 加 入 该 节点 实现 项 部 导航 栏 效果 。 由 
于 App 内 部 存在 多 个 活动 页 面 ， 为 了 确保 所 有 页 面 的 风格 统一 ， 因 此 必须 给 每 个 页 面 的 布局 
文件 添加 Toolbar。 如 此 一 来 ， 这 些 XML 文件 几乎 包含 一 模 一 样 的 Toolbar 布局 ， 不 但 造成 重 
复 布 局 ， 而 且 不 易 扩 展 ， 因 为 每 往 导 航 栏 上 增加 一 个 新 控件 ， 都 得 把 涉及 的 XML 文件 统统 修 
改过 去 。 

这 种 重复 的 导航 栏 布 局 ， 若 能 参照 代码 中 的 公共 函数 抽出 来 形成 单独 的 公共 布局 文件 ， 
由 各 个 页 面 布 局 文件 分 别 引 用 ， 沁 不 妙 哉 ? Android 确实 提供 了 对 应 的 途径 ， 只 要 在 页 面 布局 
中 使 用 include 标签 声明 公共 布局 ， 即 可 实现 在 该 页 面 中 导入 公共 布局 内 容 ， 功 能 类 似 于 Java 
的 import 或 C/C++ 的 include 关键 字 。include 标签 适用 于 在 多 个 布局 文件 中 导入 相同 的 XML 
布局 片段 ， 比 如 相同 的 标题 栏 、 相 同 的 广告 栏 、 相 同 的 进度 栏 等 。include 标签 的 用 法 很 简单 ， 
只 需 一 行 配置 即 可 完成 公共 布局 引用 ， 如 下 面 的 代码 表示 引用 了 一 个 名 为 common_title.xml 
的 公共 布局 文件 : 

<include layout="(@layout/common_title" /> 


公共 布局 文件 的 根 节点 可 以 是 LinearLayout、RelativeLayout 等 布局 节点 ， 不 过 外 部 的 页 
面 布 局 文件 往往 已 经 有 了 相同 的 布局 节点 , 这 时 子 布局 的 根 节点 就 变 成 元 余 的 了 , 但 是 布局 文 
件 必 须 有 根 布 局 节点 ， 不 能 把 控件 作为 根 节 点 。 为 了 解决 根 布局 元 余 的 问题 ，Android 提供 了 
merge 标签 进行 布局 优化 ， 即 把 merge 标签 作为 公共 布局 文件 的 根 节点 。merge 标签 代替 了 
LinearLayout、RelativeLayout 等 原 根 节点 的 位 置 ， 也 就 是 告诉 编译 器 : 我 只 是 一 个 占 位 的 合并 
标签 , 不 需要 对 我 做 布局 处 理 。 这样 ，App 在 演 染 界面 时 只 是 原样 导入 merge 标签 下 的 视图 内 
容 ， 不 做 根 布 局 尺寸 的 计算 和 调整 ， 从 而 提高 了 UI 的 加 载 效率 。 

为 了 更 好 理解 include 与 merge 标签 的 用 法 ， 接 下 来 举 一 个 公共 布局 文件 的 例子 : 

<merge xmlns:android="http://schemas.android.com/apk/res/android" 

xmlns:app="http://schemas.android.com/apk/res-auto" > 





<android.support.v7.widget.Toolbar 
android:id="@+id/tl_head" 
android:layout_width="match_parent" 
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android:layout_height="50dp" 
android:background="(@color/blue light" 
app:navigationIcon="@drawable/ic_back" > 


<RelativeLayout 
android:layout width-"match parent" 
android:layout height-"wrap content" > 


«TextView 
android:id-" (2) id/tv title" 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:layout centerInParent-"true" 
android:paddingRight-"50dp" 
android:textColor-"(g)color/black" 
android:textSize-"20sp" /> 


<ImageView 
android:id="(@+id/iv_share" 
android:layout width-"wrap content" 
android:layout height-"match parent" 
android:layout alignParentRight-"true" 
android:src-"(a)drawable/ic share" 
android:scaleType-"fitCenter" /> 
«/RelativeLayout^ 
«/android.support.v7.widget. Toolbar 
«merge» 


处 理 公 共 布 局 必然 要 有 对 应 的 公共 页 面 代 码 , 为 此 我 们 声明 一 个 名 为 BaseActivity 的 活动 
基 类 ， 该 基 类 默认 处 理 公共 布局 中 的 控件 操作 ， 具 体 的 活动 页 面 由 BaseActivity 派生 而 来 。 活 
动 基 类 的 示例 代码 如 下 : 


public class BaseActivity extends AppCompatActivity í 
(@Override 
protected void onResume() í 
super.onResume(); 
Toolbar tl head = (Toolbar) find ViewById(R.id.tl head); 
setSupportActionBar(tl head); 
tl head.setNavigationOnClickListener(new OnClickListener() í 
(@Override 
public void onClick(View view) í 
finish(); 





» 
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findViewById(R.id.iv share).setOnClickListener(new OnClickListener() í 
(GOverride 
public void onClick(View v) í 
Toast.makeText(BaseActivity.this, "请 先 实现 分 享 功能 ", ToasLLENGTH. LONG). 


show(); 
H 
» 
} 
protected void setTitle(String title) { 
TextView tv title = (TextView) findViewById(R.id.tv_title); 
tv_title.setText(title); 
h 
J 





最 后 给 出 两 个 实际 页 面 的 布局 ， 分 别 使 用 include 标签 导入 公共 布局 common title, JS 
在 代码 中 分 别 从 BaseActivity 派生 两 个 具体 的 页 面 类 。 其 中 一 个 页 面 的 代码 举例 如 下 : 
public class IncludeOneActivity extends BaseActivity í 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity include one); 
setTitle(" 时 事 频道 "); 


j 
运行 后 的 公共 导航 栏 效果 如 图 16-1 和 图 16-2 Bros. E 16-1 所 示 为 第 一 个 时 事 频道 的 界 
面 。 图 16-2 所 示 为 第 二 个 体育 频道 的 界面 。 


体育 频道 


这 是 采用 了 公共 导航 的 第 二 个 页 面 


这 是 采用 了 公共 导航 的 第 一 个 页 面 








图 16-1 时 事 频道 页 面 图 16-2 体育 频道 页 面 
16.1.2” 自 适应 调整 布局 


在 页 面 上 根据 条 件 展示 不 同 的 视图 常常 需要 设置 视图 的 可 视 属性 。 比 如 调用 setVisibility 
方法 设置 可 视 属性 ， 若 需 展示 则 将 可 视 属 性 设置 为 View.VISIBLE， 若 需 隐 藏 则 将 可 视 属性 设 
TJ View.GONE. 然而 gone 的 视图 只 是 看 不 到 罢了 ,在 界面 泻 染 时 还 是 会 被 加 载 。 要 想 事先 
不 加 载 视图 ， 在 条 件 匹 配 时 才 加 载 ， 就 可 以 使 用 标签 ViewStub 。 

占 位 视图 ViewStub 类 似 一 个 简单 的 View， 但 其 内 部 布局 由 属性 layout 指定 。 在 App 加 
载 页 面 时 ，ViewStub 并 不 显示 布局 内 容 ， 只 有 在 代码 中 调用 ViewStub 对 象 的 inflate 方法 时 ， 
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layout 指定 的 布局 才 会 展示 出 来 。 基于 以 上 处 理 逻辑 ,ViewStub 在 提高 布局 性 能 上 有 以 下 两 个 


(1) ViewStub 在 加 载 时 只 占用 大 约 一 个 View 的 内 存 ， 不 占用 layout 整个 布局 需要 的 内 存 。 
(2) ViewStub 一 旦 调用 inflate 方法 ， 就 立即 显示 所 包含 的 页 面 内 容 。 如 果 还 想 再 次 隐藏 
或 显示 布局 ， 就 要 通过 setVisibility 方法 实现 。 
举 一 个 ViewStub 实际 运用 的 例子 ， 手 机 在 竖 屏 和 横 屏 之 间 切 换 时 ， 有 时 希望 显示 不 同 的 
布局 ， 比 如 竖 屏 显示 列表 、 横 屏 显 示 网 格 。 如 此 一 来 ， 在 页 面 布局 中 预 留 两 个 ViewStub 节点 ， 
-个 给 ListView 占 位 ， 另 一 个 给 GridView 占 位 ， 具 体 的 布局 内 容 如 下 : 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width-"match parent" 





android:layout height-"match parent" 
android:orientation-" vertical" > 


«include layout-"(aàlayout/common title" /> 


«ViewStub 
android:id-"(g)*id/vs list" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:layout-"(g)layout/viewstub list" /> 


«ViewStub 
android:id-"(g)*id/vs grid" 
android:layout width-"match parent" 
android:layout height-"match parent" 
android:layout-"(glayout/viewstub grid" /> 
«/LinearLayout^ 


相对 应 的 ， 页 面 代码 增加 对 横竖 屏 的 方向 判断 ， 如 果 当 前 为 竖 屏 ， 就 令 占 位 视图 显示 列 
表 布 局 ， 如 果 当 前 为 横 屏 ， 就 令 占 位 视图 显示 网 格 布局 。 页 面 代码 举例 如 下 : 


public class ScreenSuitableActivity extends BaseActivity í 
(@Override 
protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity screen suitable); 
setTitle(" 自 适应 布局 演示 页 面 "); 
Configuration config = getResources().getConfiguration(); 
if(config.orientation — Configuration.ORIENTATION_PORTRAIT){ 
showList(); 
} else í 
showGrid(); 
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private void showList() í 
ViewStub vs list = (ViewStub) findViewByld(R.id.vs_ list); 
vs listinflate(); 
ListView lv hello = (ListView) findViewByld(R.id.lv hello); 
PlanetAdapter adapter — new PlanetAdapter(this, R.layout.item list, 
Planet.getDefaultList(), Color. WHITE); 
lv hello.setAdapter(adapter); 


private void showGrid() í 
ViewStub vs grid = (ViewStub) find ViewById(R.id.vs grid); 
vs grid.inflate(); 
GridView gv hello = (GridView) findViewById(R.id.gv hello); 
Planet Adapter adapter = new PlanetAdapter(this, R.layout.item grid, 
Planet.getDefaultList(), Color. WHITE); 
gv. hello.setAdapter(adapter); 


} 
上 述 自 适 应 布局 的 演示 效果 如 图 16-3 和 图 16-4 所 示 。 图 16-3 所 示 为 展示 列表 的 竖 屏 界 
Hl. E 16-4 所 示 为 展示 网 格 的 横 屏 界面 。 


自 适应 布局 演示 页 面 


水 星 

水 星 是 太阳 系 八 大 行星 最 为 侧 也 是 最 小 的 一 条 行星 ， 
是 内 太阳 是 近 的 行星 

金星 

£ERBARRAXAGEI- HG EA 
阳 0.725 天 文 单位 


地 球 
地 球 是 太阳 系 八大 行星 之 一 ， 排行 第 三 ， 也 是 太阳 系 
直径 、 质 量 和 包公 最大 的 类 地 行星 ,距离 太阳 1.5 亿 公 








自 适应 布局 演示 页 面 
水 星 金星 地 球 
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GRRAREAAGRRANCERAO |£ERXBR/AXGCEZ—, ME | 地 未 是 太阳 系 八 大 行星 之 一 ,排行 第 
颗 行 星 ， 也 是 高 太阳 最 近 的 行星 = , IBIEATED.T25 X S 三 MR AK: IBS 
UM EIL] 


火星 木星 += 


Li EH E 


星之 一 ， 排行 第 。。 | 木星 是 太阳 系 八大 行星 中 体积 最 大 、 咎 转 | 土星 为 太阳 系 八大 行星 之 一 ， 排 行 第 
FE, 直径 约 为 地 球 的 53% MANTE , HIR. CORSA | 六 ,体积 仅 次 于 木星 
的 干 分 之 一 ， 但 为 太 阳 系 中 其 它 七 大 行星 


里 
火星 

火星 是 太阳 系 八大 行星 之 一 ， 排行 第 四 ,属于 类 地 行 
星 ,直径 约 为 地 球 的 53% 





木星 是 太阳 系 八 大 行星 中 体积 最 大 、 自 转 最 快 的 行 
星 ， 排行 第 五 ， 它 的 质量 为 太阳 的 千 分 之 一 ， 但 为 太 f 
系 中 其 它 七 大 行星 质量 总 和 的 2.5 倍 

土星 


士 星 为 太阳 系 八大 行星 之 一 ， 排 行 第 六 ， 体 积 仅 次 于 ; 
星 


















163 ” 占 位 视图 展示 竖 屏 列表 图 16-4 占 位 视图 展示 横 屏 网 格 





16.1.3 自 定 义 窗口 主题 








使 用 Android Studio 创建 一 个 新 模块 ， 默 认 的 App 主题 为 系统 自 带 的 
Theme.AppCompat.Light.DarkActionBar， 即 浅 灰 背景 加 深 色 导航 栏 。 如 果 大 家 都 用 默认 主题 ， 














Android Studio 开发 实战 :从 零 基 础 到 App 上 线 





App 势必 变 得 干 篇 一 律 、 毫 无 特色 。 要 想 让 自己 的 App 吸引 眼球 ， 首 先 得 打造 非 同 一 般 的 主 
题 ， 比 如 粉红 的 小 女人 风格 、 草 绿 的 小 清新 风格 、 天 蓝 的 问 骚 男 风格 等 。 

自 定义 主题 的 配置 可 在 res/values/styles.xml 中 定义 ， 配 置 方式 同一 般 视 图 的 style 风格 配 
置 , 不 同 的 是 如 何 应 用 自 定义 主题 。 一 般 视图 可 在 布局 文件 的 节点 中 使 用 style 属性 设置 风格 ， 
对 于 视窗 则 可 通过 以 下 途径 设置 主题 : 


(1) 修改 AndroidManifest.xml， 往 application 节点 增加 android:theme 属性 ， 表 示 对 该 
App 的 所 有 页 面 设置 指定 的 主题 ; 或 者 往 activity 节点 增加 android:theme 属性 ， 表 示 对 指定 的 
活动 页 面 单独 设置 主题 。 
(2) 打开 Activity 代码 ， 在 setContentView 方法 之 前 调用 方法 setTheme(R.style.***) 完 成 
该 页 面 的 主题 设置 。 
G) 如 果 是 自 定义 对 话 框 ， 就 在 Dialog 的 构造 函数 中 传 入 指定 主题 的 资源 编号 。 
下 面 介绍 窗口 主题 经 常 需要 自 定义 的 属性 。 


android:gravity: 窗口 内 部 的 对 齐 方式 。 

android:background: 窗口 内 部 的 背景 。 

android:windowBackground: 整个 窗口 的 背景 ， 包 括 边框 与 内 部 。 

android:windowFrame: 窗口 框架 图 像 。 注意 该 属性 并 不 只 是 边框 区 域 ,还 包括 内 部 窗口 ， 
所 以 如 果 windowFrame 设置 为 不 透明 的 图 像 ,那么 内 部 窗口 将 只 显示 这 幅 不 透明 的 图 像 。 
android:windowNoTitle: 窗口 是 否 不 要 默认 的 标题 栏 ， 即 是 否 展 示 ActionBar。 
android:windowFullscreen: 窗口 是 否 全 屏 。 

android:windowIsTranslucent: 窗口 是 否 半 透 明 。 

android:windowIsFloating: 窗口 是 否 悬 浮 。 

android:windowAnimationStyle: 窗口 切换 动画 的 样式 。 

android:windowEnterAnimation: 进入 窗口 的 动画 。 

android:windowExitAnimation: 退出 窗口 的 动画 。 


在 以 上 属性 中 , 与 背景 设置 有 关 的 3 个 属性 容易 混淆 ， 
分 别 是 android:windowFrame, android:windowBackground 
和 android:background。 下 面 测试 一 下 这 3 个 属性 对 应 的 视 
窗 界面 ， 看 看 究竟 是 什么 模样 。 

首先 设 定 页 面 背 景 是 绿色 ， 接 着 将 
android:windowBackground 设置 为 半 透 明 红 色 ， 效 果 如 图 . 
16-5 所 示 。 此 时 对 话 框 外 围 变 为 深 黄 绿色 ， 即 窗口 对 外 半 。 图 165 windowBackground 设置 为 
透明 ， 使 得 页 面 背景 与 窗口 背景 混合 在 一 起 。 aen ea 

然后 将 android:background 设置 为 半 透 明 红色 , 效果 如 图 16-6 所 示 。 此 时 对 话 框 外 围 变 为 
红色 ， 四 周边 框 为 深 绿色 ， 表 示 窗 口内 部 对 外 不 透明 ， 但 窗口 边框 对 外 透明 。 

最 后 将 android:windowFrame 设置 为 半 透 明 红 色 , 效果 如 图 16-7 所 示 。 此 时 对 话 框 内 部 蒙 
上 半 透 明 红色 , 四 周边 框 变 为 黄 绿色 ,说 明 窗 口内 部 对 外 不 透明 但 对 内 半 透 明 ， 窗口 边框 对 外 
半 透 明 。 


e o o òo oò o o 
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消息 标题 
消息 内 容 
确定 
图 16-6 background 设置 为 半 透 明 红色 的 效果 图 16-7 windowFrame 设置 为 半 透 明 红色 的 效果 


16.2 内存 泄漏 处 理 


内 存 泄漏 指 的 是 程序 运行 时 未 能 正确 回收 部 分 内 存 ， 导 致 这 些 内 存 既 不 能 被 自身 使 用 ， 
又 不 能 被 其 他 程序 使 用 ， 从 而 变 成 垃圾 内 存 。 一 旦 内 存 泄漏 无 法 得 到 控制 ， 该 程序 占用 的 内 存 
就 越 来 越 大 ， 最 终 只 能 强行 结束 ， 否 则 会 导致 系统 死机 。 本 节 首 先 介绍 Android 开发 如 何 检测 
内 存 汇 漏 ， 然 后 详细 阐述 各 种 场景 下 的 内 存 汇 漏 预 防 措施 。 


16.24 内 存 泄漏 的 检测 


CC++ 存 在 指针 的 概念 ， 每 当 程序 需要 处 理 数 据 时 ， 便 从 内 存 中 开辟 一 块 区 域 ， 并 把 该 区 
域 的 首 地 址 赋值 给 一 个 指针 , 这 样 程序 才能 够 操作 该 指针 指向 的 内 存 。 因 为 C/C++ 设计 上 的 原 
因 ， 手 工分 配 的 内 存 也 要 手工 释放 ， 如 果 没 有 及 时 释放 内 存 就 会 产生 内 存 泄 漏 。Java 设计 之 
初 已 经 实现 了 多 数 情况 的 内 存 自 动 回收 , 不 过 在 Android 开发 中 , 内 存 回 收 机 制 并 不 总 会 奏效 。 
情况 一 是 调用 了 非 Java 接口 ， 比 如 调用 了 JNI 接 口 , JNI 代码 中 由 C/C++ 分 配 的 内 存 就 要 手工 
回收 ， 情 况 二 是 调用 了 外 部 服务 ， 使 用 完毕 就 得 手工 通知 外 部 服务 回收 ;情况 三 是 异步 处 理 ， 
实时 的 内 存 回 收 机 制 显然 等 不 了 耗 时 较 久 的 异步 处 理 任务 。 

要 对 内 存 泄漏 问题 进行 优化 , 首先 得 检测 App 是 否 发 生 内 存 泄漏 。 正常 情况 下 , 一 个 App 
占用 的 内 存 有 一 个 峰值 ， 达 到 这 个 峰值 后 ， 只 要 退出 App 页 面 ， 占 用 的 内 存 大 小 就 会 降下 来 。 
但 是 如 果 产 生 内 存 泄漏 ， 这 个 App 占用 的 内 存 大 小 是 没有 峰值 的 ， 随 着 页 面 的 重复 打开 或 时 
间 的 不 断 流逝 ， 该 App 消耗 的 内 存 越 变 越 大 ， 这 便 表示 出 现 了 内 存 泄漏 状况 。 因 此 ， 只 要 能 
够 监控 App 的 运行 内 存 变 化 情况 ， 即 可 间接 判断 这 个 App 是 否 发 生 内 存 泄漏 。 

Android Studio 自 带 了 简单 的 内 存 检 测 工具 ， 使 用 Android Studio 运行 测试 应 用 时 ， 在 主 
界面 左下 角 的 logcat 窗口 左 侧 从 上 往 下 数 第 3 个 按钮 为 System Information， 单 击 该 按钮 会 在 
右边 弹出 菜单 窗口 ， 如 图 16-8 所 示 。 

菜单 项 中 的 Memory Usage 表示 查看 内 存 用 量 。 单 击 该 菜单 项 ， 代 码 主 窗口 会 显示 测试 设 
备 上 的 内 存 使 用 情况 ， 如 图 16-9 所 示 。 可 以 看 到 当前 测试 应 用 performance 的 内 存 消耗 量 为 
8573KB， 在 该 App 上 点 击 ， 打 开 一 个 包含 多 张 图 片 的 页 面 ， 再 次 单 击 Memory Usage 查看 内 
存 用 量 ， 此 时 的 内 存 统计 结果 如 图 16-10 所 示 。 
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图 16-9 测试 设备 的 初始 内 存 使 用 状况 16-10 打开 App 页 面 后 的 内 存 使 用 状况 


这 时 测试 应 用 performance 的 内 存 消耗 量 达到 了 22212KB， 反 复 打 开 和 关闭 页 面 ,然后 重 
复 内 存 查 看 操作 。 如 果 发 现 App 占用 的 内 存 只 增 不 减 ， 那 么 毫 无 疑问 发 生 了 内 存 泄 漏 。 
为 进一步 观察 内 存 泄 露 现象 ， 下 面 给 出 两 个 例子 分 别 进行 说 明 。 


1. 未 能 移 除 定时 的 Runnable 任务 


前 面 各 章 有 需要 延 时 处 理 时 ， 常 常 调用 Handler 对 象 的 postDelayed 方法 ， 由 该 方法 延迟 
- 段 时 间 后 执行 设 定好 的 Runnable 任务 。 若 要 实现 动画 效果 ， 则 循环 执行 若干 次 postDelayed 

方法 。 你 可 曾 想 过 ， 这 里 蕴含 着 不 小 的 内 存 泄漏 风险 ， 如 果 不 谨慎 对 待 ，App 很 可 能 多 跑 几 次 
就 挂 了 。 

比如 下 面 的 代码 每 隔 两 秒 打印 一 行 日 志 , 并 在 onDestroy 页 面 退出 时 根据 开关 判断 是 否 移 
除 任务 ， 完 整 代码 如 下 : 

public class RemoveTaskActivity extends AppCompatActivity implements OnClickListener í 

private boolean bRun = false; 





private CheckBox ck remove; 
private TextView tv remove; 
private Button btn remove; 
private String mDesc = ""; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity remove task); 
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ck remove = (CheckBox) findViewByld(R.id.ck remove); 

tv remove = (Text View) findViewById(R.id.tv remove); 

btn remove = (Button) findViewById(R.id.btn remove); 

btn remove.setOnClickListener(this); 

TextView tv start = (TextView) findViewById(R.id.tv start); 

tv_start.setText(" 页 面 打 开 时 间 为 : "+Utils.getNowTime()); 
Ë 


@Override 
public void onClick(View v) { 
if (v.getId() = R.id.btn_remove) { 
if (bRun != true) { 
btn_remove.setText(" 取 消 定时 任务 "); 
mHandler.post(mTask); 
} else í 
btn_remove.setText(" 开 始 定时 任务 "); 
mHandler.removeCallbacks(mTask); 


J 
bRun = !bRun; 
j 
} 
@Override 
protected void onDestroy() { 
super.onDestroy(); 
if (ck_remove.isChecked() = true) { 
mHandler.removeCallbacks(mTask); 
J 
j 


private Handler mHandler = new Handler); 
private Runnable mTask = new Runnable() í 
@Override 
public void run() { 
Intent intent = new Intent(TASK EVENT); 
LocalBroadcastManager.getInstance(RemoveTaskActivity.this).sendBroadcast(intent); 
mHandler.postDelayed(this, 2000); 


h 
(à Override 
public void onStart() í 
super.onStart(); 
taskReceiver — new TaskReceiver(); 
IntentFilter filter = new IntentFilter(TASK EVENT); 
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LocalBroadcastManager.getInstance(this).registerReceiver(taskReceiver, filter); 
} 
@Override 
public void onStop() í 
LocalBroadcastManager.getInstance(this).unregisterReceiver(taskReceiver); 
super.onStop(); 
} 
private String TASK EVENT = "com.example.performance.task"; 
private TaskReceiver taskReceiver; 
private class TaskReceiver extends BroadcastReceiver í 
@Override 
public void onReceive(Context context, Intent intent) { 
if (intent != null) í 
mDesc = String. format("%s%s 打印 了 一 行 测试 日 志 \n", mDesc, Utils.getNowTime()); 
tv_remove.setText(mDesc); 


} 

首次 进入 该 测试 页 面 ， 点 击 “ 开 始 定时 任务 ”按钮 后 ， 页 面 每 隔 两 秒 打印 一 行 日 志 ， 如 
图 16-11 所 示 。 然 后 不 停止 也 不 移 除 定时 任务 ,直接 退出 该 页 面 ， 按 道理 原 测试 页 面 上 的 内 存 
都 应 该 回收 。 不 过 接着 重新 进入 测试 页 面 ， 还 没 点 击 “ 开 始 定时 任务 ”按钮 ， 页 面 已 经 在 元 自 
欢快 地 打印 日 志 了 ， 如 图 16-12 所 示 ， 很 明显 上 次 退出 页 面 时 系统 未 能 自动 回收 内 存 。 








performance performance 


口 退出 时 是 否 回收 任务 口 退出 时 是 否 回收 任务 
取消 定时 任务 开始 定时 任务 


页 面 打开 时 间 为 : 16:54:38 页 面 打开 时 间 为 : 16:55:53 
16:54:58 打印 了 一 行 测试 日 志 16:55:54 打印 了 一 行 测试 日 志 
16:55:00 打印 了 一 行 测试 日 志 16:55:56 打印 了 一 行 测试 日 志 
16:55:02 打印 了 一 行 测试 日 志 16:55:58 打印 了 一 行 测试 日 志 





图 16-11 开始 定时 任务 的 测试 页 面 图 16-12 重新 进入 测试 页 面 的 情况 
2. 未 能 注销 系统 的 闹钟 提醒 服务 
定时 处 理 除了 可 以 循环 调用 postDelayed 方法 外 ， 还 可 以 在 系统 的 闹钟 提 醒 服务 中 注册 定 
时 事件 ， 并 接收 系统 的 闲 钟 广播 进行 定时 处 理 。 使 用 系统 服务 也 需 小 心 , 因 为 系统 的 后 台 服 务 
不 知道 App 页 面 会 在 什么 时 候 关闭 ， 若 放任 自流 ， 则 又 是 一 个 内 存 泄漏 的 引爆 点 。 
比如 下 面 的 代码 利用 六 钟 提醒 服务 每 隔 3 秒 打印 一 行 日 志 ,并 在 onDestroy 中 根据 开关 判 
断 是 否 注销 服务 ， 完 整 代码 如 下 : 


public class LogoutServiceActivity extends AppCompatActivity implements OnClickListener í 
private static final String TAG = "LogoutServiceActivity"; 
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private boolean bRun = false; 

private CheckBox ck logout; 

private Button btn alarm; 

private static TextView tv alarm; 

private PendingIntent pIntent; 

private Alarm Manager mAlarmManager; 
private static String mDesc; 


@Override 

protected void onCreate(Bundle savedInstanceState) í 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity logout service); 
ck logout = (CheckBox) find ViewById(R.id.ck logout); 
tv alarm = (TextView) findViewByld(R.id.tv alarm); 
btn alarm = (Button) findViewByld(R.id.btn alarm); 
btn alarm.setOnClickListener(this); 
Intent intent = new Intent(SERVICE EVENT); 
plntent = PendingIntent.getBroadcast(this, 0, intent, PendingInten.FLAG UPDATE CURRENT); 
mAlarmManager = (AlarmManager) getSystemServic(ALARM SERVICE); 
mDesc = "": 
TextView tv start = (TextView) findViewById(R.id.tv start); 
tv_start.setText(" 页 面 打开 时 间 为 : "+Utils.getNowTime()); 


@Override 
protected void onDestroy() { 
super.onDestroy(); 
if (ck_logout.isChecked() == true) í 
mAlarmManager.cancel(pIntent); 


(a Override 
public void onClick(View v) í 
if (v.getId() == R.id.btn alarm) í 
if (bRun !- true) í 
mAlarmManager.setRepeating( AlarmManager.RTC. WAKEUP, 
System.currentTimeMillis(), 3000, pIntent); 
mbDesc = Utils.getNowTime() - ”设置 闹钟 "; 
tv alarm.setText(mDesc); 
btn alarm.setText(" H Bil Ph"); 
} else í 
mAlarmManager.cancel(plntent); 
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btn_alarm.setText(" 设 置 闹钟 ); 


j 
bRun = !bRun; 


) 


private String SERVICE EVENT = "com.example.performance.service 1"; 
public static class ServiceReceiver extends BroadcastReceiver í 
(@Override 
public void onReceive(Context context, Intent intent) í 
if (intent != null) í 
Log.d(TAG, "ServiceReceiver onReceive"); 
if (tv alarm != null) { 
mDesc = String.format("%sn%s [# Fi [8] 835", mDesc, Utils.getNowTime()); 
tv alarm.setText(mDesc); 


j 

首次 进入 该 测试 页 面 , 点 击 “ 设 置 闹钟 ”按钮 后 , 页 面 每 隔 3 秒 打印 一 行 日 志 , 如 图 16-13 
所 示 。 然 后 不 取消 也 不 注销 闹钟 服务 ， 直 接 退 出 该 页 面 ， 接 着 重新 进入 测试 页 面 ， 还 没 点 击 设 
置 按钮 ， 页 面 却 已 经 在 不 断 刷新 日 志 了 ， 如 图 16-14 所 示 , 很 遗憾 上 次 的 闵 钟 设置 也 产生 了 内 











performance performance 
口 退出 时 是 否 注销 服务 口 退出 时 是 否 注销 服务 
取消 闹钟 设置 闹钟 
页 面 打开 时 间 为 : 16:56:23 页 面 打开 时 间 为 : 16:57:08 

16:56:29 设置 闹钟 

16:56:29 闹钟 时 间 到 达 16:57:11 iA phata 
16:56:32 闹钟 时 间 到 达 16:57:14 闲 钟 时 间 到 达 
16:56:35 闹钟 时 间 到 达 16:57:17 闹钟 时 间 到 达 

图 16-13 ”设置 闹钟 后 的 测试 页 面 图 16-14 重新 进入 测试 页 面 的 情况 


16.22 ”内 存 泄漏 的 预防 


App 开发 中 的 内 存 泄漏 常见 于 以 下 5 个 场景 : 


(1) 数据 库 查 询 操作 后 没有 关闭 游标 Cursor。 

(2) 适配器 Adapter 刷新 数据 时 没有 重用 convertView 对 象 。 

(3) Bitmap 对 象 使 用 完毕 没有 调用 recycle 方法 回收 内 存 。 

(4) Activity 引用 了 耗 时 对 象 ， 造 成 页 面 关 闭 时 无 法 释放 被 引用 的 对 象 。 
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(5) 给 系统 服务 注册 了 监听 任务 ， 却 没有 及 时 注销 。 


要 想 避 免 出 现 内 存 泄漏 ， 最 好 的 办 法 是 防 患 于 未 然 。 针 对 以 上 5 个 内 存 泄漏 场景 ， 相 应 
的 预防 措施 分 别 介绍 如 下 : 
1. 关闭 游标 


游标 Cursor 不 止 用 于 数据 库 SQLite 查询 记录 , 也 可 用 于 内 容 解析 器 ContentResolver 查询 
内 容 数 据 ， 还 可 用 于 下 载 管 理 器 DownloadManager 查询 下 载 进度 。 

若 要 预防 游标 产生 的 内 存 泄漏 , 则 可 在 每 次 查询 操作 结束 后 调用 Cursor 对 象 的 close 方法 

2. 重用 适 配 


App 往 列 表 视 图 ListView 或 网 格 视图 GridView 中 填充 数据 都 是 通过 适配器 BaseAdapter 
的 getView 方法 展示 列表 元 素 。 列 表 元 素 较 多 时 ， 系 统 只 会 加 载 屏幕 上 可 见 的 元 素 ， 其 他 元 素 
只 有 滑动 到 屏幕 区 域内 才 会 即时 加 载 并 显示 。 当 列表 元 素 多 次 处 于 “展示 一 隐藏 一 展示 一 隐 
藏 ……” 时 ， 有 必要 重用 每 个 元 素 的 视图 ; 如 果 不 重用 ， 那 么 每 次 展示 可 视 元 素 都 得 重新 分 配 
视图 对 象 ， 这 便 产 生 了 内 存 泄露 。 
重用 适 配 可 先 判 断 convertView 对 象 ， 如 果 该 对 象 为 空 ， 就 为 其 分 配 视图 对 象 ， 并 调用 
setTag 方法 保存 视图 持 有 者 ， 如 果 该 对 象 非 空 ， 就 调用 getTag 方法 获取 视图 持 有 者 。 下 面 是 
重用 列表 元 素 的 代码 示例 : 
ViewHolder holder = null; 
if (convertView — null) í 
holder = new ViewHolder(); 
convertView = minflater.inflate(R.layout.list title, null); 
holder.tv seq = (TextView) convertView.find ViewById(R.id.tv seq); 
holder.iv title = (ImageView) convertView.findViewById(R.id.iv title); 
convertView.setTag(holder); 
) else ( 
holder — (ViewHolder) convertView.getTag(); 





) 
每 次 给 ListView 与 GridView 构造 适配器 都 要 加 入 上 述 重用 代码 ,已 经 成 了 开发 者 的 一 大 
负担 。 所 以 Android 在 5.0 之 后 推出 了 循环 视图 RecyclerView， 它 的 适配器 自动 实现 视图 持 有 
者 ViewHolder， 无 须 开发 者 进行 重用 判断 的 处 理 ， 算 是 一 件 善事 。 


3. 回收 图 像 


Android 虽然 定义 了 Bitmap 类 ， 但 是 读 取 图 像 数据 的 底层 操作 并 非 由 Java 代码 完成 。 查 
看 SDK 源码 , 在 BitmapFactory 类 中 一 路 跟踪 到 nativeDecodeStream 函数 , 发 现 它 其 实 是 一 个 
native 方法 ， 也 就 是 该 方法 来 自 于 JNI 接口 。 既 然 Bitmap 的 图 像 数 据 实际 来 自 于 C/C++ 代码 ， 
那么 确实 得 手工 释放 C/C++ 的 内 存 资源 。 查看 Bitmap 类 的 源码 , 它 的 回收 方法 recycle 用 到 的 
nativeRecycle 函数 其 实 也 是 一 个 native 方法 ， 同 样 来 自 于 JNI 接口。 
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因此 , 若 想 避 免 图 像 操作 引起 的 内 存 泄漏 , 可 在 Bitmap 对 象 使 用 完毕 后 调用 recycle 方法 。 
举一反三 ， 只 要 一 个 资源 是 在 JNI 接口 中 分 配 的 ， 一 旦 不 再 使 用 该 资源 ， 就 得 手工 调用 该 资源 
对 应 的 JNI 回收 接口 。 


4. 释放 引用 


编写 Handler 的 处 理 函数 时 , Android Studio 提示 This Handler class should be static or leaks 
might occur， 意 思 是 这 个 类 应 该 是 一 个 静态 类 ， 否 则 可 能 发 生 内 存 泄漏 。 因 为 Handler 对 象 经 
常 处 理 异步 任务 ， 每 当 它 调用 postDelayed 方法 执行 一 个 任务 时 ， 依 据 延 迟 间 隔 都 得 等 待 一 段 
时 间 ， 倘 若 活 动 页 面 在 此 期 间 退出 ， 就 会 导致 异步 任务 持 有 的 引用 无 法 回收 。 由 于 Runnable 
通常 持 有 Activity 的 引用 ， 因 此 造成 Activity 资源 都 无 法 回收 。 
上 面 的 描述 可 能 不 好 理解 ， 确 实 也 不 容易 解释 清楚 ， 还 是 直接 跳 过 人 烦琐 的 概念 ， 讲 讲 如 
何 解决 该 情况 的 内 存 泄漏 问题 。 下 面 是 预防 这 种 内 存 汇 漏 的 3 个 方法 : 
a) 如 果 异 步 任 务 是 由 Handler 对 象 的 postDelayed 方法 发 起 的 ， 那 么 可 用 对 应 的 
removeCallbacks 方法 回收 ， 把 消息 对 象 从 消息 队列 移 除 就 行 了 。 
(2) 按 Android 官方 的 推荐 做 法 ， 可 把 Handler 类 改 为 静态 类 ， 同 时 Handler 内 部 使 用 
WeakReference 关键 字 持 有 目标 的 引用 。 


之 所 以 使 用 静态 类 ， 是 因为 静态 类 不 持 有 目标 的 引用 ， 不 会 影响 内 存 自动 回收 机 制 。 但 
是 不 持 有 目标 的 引用 ，Handler 内 部 就 无 法 操作 Activity 上 面 的 控件 。 为 解决 该 问题 ， 在 构造 
Handler 类 时 需要 初始 化 目标 的 弱 引用 。 不 同 于 前 面 的 强 引 用 ， 弱 引用 相当 于 一 个 指针 ， 指 针 
指向 的 地 址 随时 可 以 回收 。 这 又 带 来 一 个 新 问题 ， 即 弱 引 用 指向 的 对 象 可 能 是 空 的 ， 所 以 
Handler 内 部 在 使 用 目标 活动 前 要 先 判断 弱 引 用 对 象 是 否 为 空 。 
下 面 是 弱 引 用 的 代码 片段 : 
private static class MyHandler extends Handler í 
public static WeakReference<HandlerActivity> mActivity; 
public MyHandler(HandlerActivity activity) í 
mActivity = new WeakReference<HandlerActivity>(activity); 
b 











@Override 
public void handleMessage(Message msg) { 
HandlerActivity act = mActivity.get(); 
if (act != null) í 
String desc = ProcessUtil.getRunningA ppProcessInfo(act); 
acttv memory.setText(desc); 


j 


(3) d£ Handler 对 象 作为 App 的 全 局 变量 ， 即 把 Handler 对 象 作为 自 定义 Application 类 
的 成 员 变 量 。 
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这 样 只 要 App 在 运行 ， 该 对 象 就 一 直 存 在 。 既 然 避 免 为 Handler 对 象 重复 分 配 内 存 ， 也 就 
间接 避免 了 内 存 泄漏 的 可 能 。 

5. 注销 监 

App 的 某 些 功能 依赖 于 Android 的 系统 服务 ， 比 如 定位 功能 依赖 于 系统 的 定位 管理 器 ， 定 
时 功能 依赖 于 系统 的 闹钟 管理 器 。App 若 想 接收 系统 服务 的 消息 ， 要 么 注册 监听 器 , 在 回调 方 
法 中 处 理 消 息 ; 要 么 注册 广播 接收 器 ， 在 接收 广播 时 处 理 消息 。 既 然 有 注册 操作 ， 就 存在 对 应 
的 注销 操作 ,不 过 如 果 不 注意 ,就 会 忘记 在 代码 中 做 注销 处 理 。 所 以 在 进行 页 面 编码 时 , 千 万 
要 记得 再 检查 一 遍 ， 确 保 onDestroy 方法 中 已 经 包含 相关 的 注销 代码 。 

不 同 的 系统 服务 拥有 不 同 的 注销 方法 ， 常 见 的 系统 服务 注销 方法 见 表 16-1。 


表 16-1 常见 的 系统 服务 注销 方法 











系统 服务 的 管理 器 注销 操作 说 明 注销 函数 

AlarmManager 取消 定时 广播 cancel 

ConnectivityManager 取消 监听 网 络 状态 unregisterNetworkCallback 

DownloadManager 移 除 下 载 任务 Temove 

LocationManager 取消 监听 位 置信 息 的 变化 removeUpdates 

LocationManager 取消 监听 定位 状态 的 变化 removeGpsStatusListener 

NotificationManager 取消 通知 cancel 

TelephonyManager 取消 监听 电话 状态 使 用 listen 方法 注册 一 个 空 事件 
PhoneStateListener.LISTEN_NONE 

Vibrator 取消 震动 cancel 








16.3 ”线程 地 管理 


在 批量 执行 异步 任务 时 ， 为 了 合理 、 有 效 地 利用 任务 线程 ， 需 要 引入 线程 池 统一 管理 线 
程 资源 。 就 像 数 据 库 是 对 数据 存储 封装 一 样 , 线程 池 是 对 线程 执行 封装 ,总 之 都 是 为 了 提高 系 
统 的 运行 效率 。 本 节 先 阐述 单个 线程 存在 的 问题 , 然后 依次 说 明 普通 线程 池 和 定时 器 线程 池 的 
法 。 


16.3.1 普通 线程 池 














第 10 章 介绍 多 线程 时 提 到 使 用 线程 类 Thread 开启 分 线程 , 不 过 Thread 只 处 理 自身 线程 ， 
缺乏 多 个 线程 之 间 的 统一 管理 ， 会 产生 如 下 问题 : 


CD 无 法 控制 线程 的 并 发 数 ， 一 旦 同时 启动 多 个 线程 ， 可 能 导致 程序 挂 死 。 
(2) 线程 之 间 无 法 复 用 ， 每 个 线程 都 经 历 创建 、 启 动 、 停 止 的 生命 周期 , 资源 开销 不 小 。 


由 于 单线 程 管理 存在 诸多 问题 ， 因 此 异步 任务 工具 AsyncTask 给 出 了 executeOnExecutor 
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方法 ， 人 允许 开发 者 指定 任务 线程 池 。 然 而 笔者 当时 已 经 指出 ，AsyncTask 自 带 的 THREAD_ 
POOL EXECUTOR 依然 存在 性 能 瓶颈 。 要 想 让 线程 池 的 处 理性 能 达到 最 优 ， 还 得 根据 实际 情 
况 自 定义 线程 池 的 具体 参数 。 

Android 用 到 的 是 Java 的 线程 池 ， 由 Executors 类 创建 。 系 统 已 经 封装 好 的 线程 池 说 明 见 
表 16-2。 


表 16-2 ”已 经 封装 好 的 线程 池 说 明 




















线程 池 的 创建 方法 线程 池 类 型 说 明 

newSingleThreadExecutor ExecutorService 创建 只 有 单个 线程 的 线程 池 
newFixedThreadPool ThreadPoolExecutor 创建 线程 数量 固定 的 线程 池 
newCachedThreadPool ThreadPoolExecutor 创建 无 个 数 限 制 的 线程 池 
newSingleThreadScheduledExecutor | ScheduledThreadPoolExecutor 创建 只 有 单个 线程 的 定时 器 线程 池 
newScheduledThreadPool ScheduledThreadPoolExecutor 创建 线程 数量 固定 的 定时 器 线程 池 


当然 , 线程 池 中 的 线程 数量 最 好 由 开发 者 分 配 ， 这 时 就 要 使 用 ThreadPoolExecutor 的 构造 
函数 构建 线程 池 对 象 。 下 面 是 构造 函数 的 参数 说 明 。 
e intcorePoolSize: 线程 池 的 最 小 线程 个 数 。 
e int maximumPoolSize: 线程 池 的 最 大 线程 个 数 。 
e long keepAliveTime: 非 核心 线程 在 无 任务 时 的 等 待 时 长 。 若 超过 该 时 间 仍 未 分 配 任务 ， 
则 该 线程 自动 结束 。 
e TimeUnit unit: 时 间 单 位 ， 时 间 单 位 的 取 值 说 明 见 表 16-3。 


表 16-3 ”时 间 单 位 的 取 值 说 明 





TimeUnit 类 的 时 间 单 位 
SECONDS 
MILLISECONDS 
MICROSECONDS 





e BlockingQueue<Runnable> workQueue: 设置 等 待 队列 。 取 值 new LinkedBlockingQueue 
<Runnable>(O) 即 可 ， 默 认 表 示 等 待 队列 无 穷 大 ， 此 时 工作 线程 等 于 最 小 线程 个 数 。 当 然 
也 可 在 参数 中 指定 等 待 队列 的 大 小 ， 此 时 工作 线程 数 等 于 总 任务 数 减 去 等 待 队列 大 小 ， 
工作 线程 数位 于 最 小 线程 个 数 与 最 大 线程 个 数 之 间 。 若 计算 得 到 的 工作 线程 数 小 于 最 小 
线程 个 数 ， 则 工作 线程 数 等 于 最 小 线程 个 数 ; 若 工作 线程 数 大 于 最 大 线程 个 数 ， 则 系统 
扔 出 异常 java.util.concurrent.RejectedExecutionException， 并 不 会 自动 让 工作 线程 数 等 于 
最 大 线程 个 数 。 所 以 等 待 队列 大 小 要 么 取 默 认 值 (不 设置 ) ， 要 么 设 的 尽 可 能 大 ， 否 则 
一 旦 程序 启动 大 量 线 程 ， 就 会 异常 报错 。 

e ThreadFactory threadFactory: 一 般 使 用 默认 值 即 可 。 

构建 线程 池 对 象 后 ， 还 可 在 代码 中 随时 调整 参数 ， 并 执行 任务 管理 操作 。 下 面 是 

ThreadPoolExecutor 的 常用 方法 说 明 。 
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execute: 向 执行 队列 添加 指定 的 任务 。 

remove: 从 执行 队列 移 除 指定 的 任务 。 

shutdown: 关闭 线程 池 。 

isTerminated: 判断 线程 池 是 否 关闭 。 

setCorePoolSize: 设置 线程 池 的 最 小 线程 个 数 。 
setMaximumPoolSize: 设置 线程 池 的 最 大 线程 个 数 。 
setKeepAliveTime: 设置 非 核心 线程 在 无 任务 时 的 等 待 时 长 。 
getPoolSize: 获取 当前 的 线程 个 数 。 

getActiveCount: 获取 当前 的 活动 线程 个 数 。 


各 种 普通 线程 池 的 执行 效果 如 图 16-15 一 图 16-18 所 示 。 其 中 ， 图 16-15 所 示 为 单线 程 线程 
池 的 结果 界面 ,因为 是 单线 程 , 所 以 每 隔 两 秒 打印 一 行 日 志 ; 图 16-16 所 示 为 多 线程 (4 个 线程 ) 
线程 池 的 结果 界面 ， 因 为 有 4 个 线程 ， 所 以 每 秒 打印 4 行 日 志 ; 图 16-17 所 示 为 无 限制 线程 池 
的 结果 界面 ， 因 为 不 限制 线程 个 数 ， 所 以 一 秒 内 就 把 所 有 日 志 打 印 出 来 了 ; 图 16-18 所 示 为 自 
定义 线程 (两 个 线程 ) 线程 池 的 结果 界面 ， 因 为 自 定义 了 两 个 线程 ， 所 以 每 秒 打印 两 行 日 志 。 














performance performance 
葵 通 线程 池 类 型 单线 程 线程 池 wanmi eu 多 线程 线程 池 
170052 当前 序号 是 0 16:59:52 当前 序号 是 0 
17:00:54 当前 序号 是 1 16:59:52 当前 序号 是 1 
17:00:56 当前 序号 是 2 165952 当前 序号 是 2 
17:00:58 当前 序号 是 3 16:59:52 当前 序号 是 3 
170100 当前 序号 是 4 16:59:54 当前 序号 是 4 
170102 当前 序号 是 5 16:59:54 当前 序号 是 5 
170104 当前 序号 是 6 165954 5586 
170106 当前 序号 是 7 16:59:54 当前 序号 是 7 
170108 当前 序号 是 8 16:59:56 当前 序号 是 8 
170110 当前 序号 是 9 16:59:56 当前 序号 是 9 
17:01:12 当前 序号 是 10 16:59:56 当前 序号 是 10 
17:01:14 当前 序号 是 11 16:59:56 当前 序号 是 11 
170116 当前 序号 是 12 16:59:58 当前 序号 是 12 
170118 当前 序号 是 13 16:59:58 当前 序号 是 13 
17:01:20 当前 序号 是 14 16:59:58 当前 序号 是 14 
17:01:22 当前 序号 是 15 16:59:58 当前 序号 是 15 
17:01:24 当前 序号 是 16 170000 当前 序号 是 16 
170126 tim R17 170000 当前 序号 是 18 
170128 当前 序号 是 18 170000 当前 序号 是 17 
17:01:30 当前 序号 是 19 17:00:00 当前 序号 是 19 
图 16-15 ”单线 程 线程 池 的 日 志 图 16-16 多 线程 线程 池 的 日 志 
答 通 线程 池 类 型 无 限制 线程 池 x 若 通 线程 池 类 型 自 定义 线程 池 
17:02:04 当前 序号 是 0 170234 当前 序号 是 0 
170204 当前 序号 是 1 170234 当前 厚 号 是 1 
170204 当前 序号 是 2 17:02:36 当前 序号 是 2 
17:02:04 当前 序号 是 3 170236 当前 序号 是 3 
170204 当前 序号 是 4 170238 当前 友 号 是 4 
170204 当前 序号 是 5 17:02:38 当前 序号 是 5 
170204 当前 序号 是 6 170240 当前 序号 是 6 
17:02:04 当前 序号 是 7 17:0240 当前 序号 是 7 
170204 当前 序号 是 8 17:02:42 当前 序号 是 8 
170204 当前 序号 是 9 17:02:42 当前 序号 是 9 
17:02:04 当前 序号 是 10 17:02:44 当前 序号 是 10 
17:02:04 当前 序号 是 11 17:02:44 当前 序号 是 11 
170204 当前 序号 是 12 170246 当前 序号 是 12 
17:02:04 当前 序号 是 13 170246 当前 序号 是 13 
17:02:04 当前 序号 是 14 17:02:48 当前 序号 是 14 
170204 当前 序号 是 15 170248 当前 序号 是 15 
170204 当前 序号 是 16 170250 当前 序号 是 16 
17:02:04 当前 序号 是 17 17:02:50 当前 序号 是 17 
17:02:04 当前 序号 是 18 170252 当前 序号 是 18 
170204 当前 序号 是 19 170252 当前 序号 是 19 
图 16-17 无 限制 线程 池 的 日 志 16-18 ” 自 定义 线程 池 的 日 志 
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16.3.2 ”定时 器 线程 池 


前 面 的 普通 线程 池 是 立即 执行 任务 (如 果 有 空余 线程 》， 但 有 时 我 们 并 不 希望 任务 立即 
执行 ， 而 是 延迟 一 段 时 间 再 执行 ， 这 样 便 用 到 了 定时 器 线程 池 。 

Android 同样 提供 了 封装 好 的 两 个 定时 器 线程 池 ， 即 newScheduledThreadPool 和 
newSingleThreadScheduledExecutor, 详细 说 明 见 表 16-2。 当 然 现 有 的 定时 器 线程 池 并 不 总 能 满 
足 需 求 ， 还 得 由 开发 者 自行 定制 。 具 体 说 来 ， 就 是 使 用 ScheduledThreadPoolExecutor 的 构造 函 
数 构建 定时 器 线程 池 对 象 。 下 面 是 构造 函数 的 参数 说 明 。 

e int corePoolSize: 线程 池 的 最 小 线程 个 数 。 

e ThreadFactory threadFactory: 一 般 使 用 默认 值 即 可 。ThreadFactory 是 在 线程 池 中 使 用 的 线 

程 工厂 接口 ， 定 义 了 一 个 newThread 方法 ， 该 方法 输入 Runnable 参数 ， 返 回 Thread 对 象 。 
虽然 一 般 情况 下 使 用 默认 的 DefaultThreadFactory 即 可 ， 但 是 在 某 些 特定 场合 可 以 自己 实 
现 工 厂 类 ， 用 来 跟踪 线程 的 启动 时 间 、 结 束 时 间 ， 以 及 线程 发 生 异 常 时 的 处 理 步骤 。 

e RejectedExecutionHandler handler: 一 般 使 用 默认 值 即 可 。 

定时 器 线程 池 ScheduledExecutorService 继承 了 ThreadPoolExecutor 的 所 有 方法 。 下 面 是 
定时 器 线程 池 多 出 的 几 个 定时 器 相关 方法 。 

e schedule: 延迟 一 段 时 间 后 启动 任务 。 

e scheduleAtFixedRate: 先 延 迟 一 段 时 间 ， 然 后 间隔 若干 时 间 周 期 启动 任务 。 

e scheduleWithFixedDelay: 先 延迟 一 段 时 间 ， 然 后 固定 延迟 若干 时 间 启 动 任务 。 


注意 ，scheduleAtFixedRate 和 scheduleWithFixedDelay 都 是 循环 执行 任务 ， 区 别 在 于 前 者 
的 间隔 时 间 从 上 个 任务 的 开始 时 间 起 计算 ， 后 者 的 间隔 时 间 从 上 个 任务 的 结束 时 间 起 计算 。 

定时 器 线程 池 的 执行 效果 如 图 16-19 和 图 16-20 所 示 。 其 中 ， 图 16-19 所 示 为 单线 程 的 定 
时 器 线程 池 ， 每 隔 两 秒 打 印 一 行 日 志 : 图 16-20 所 示 为 多 线程 (3 个 线程 ) 的 定时 器 线程 池 ， 
因为 有 3 个 线程 ， 所 以 每 秒 打印 3 行 日 志 。 





定时 器 线程 池 类 型 单线 程 定时 器 固定 速率 C 定时 器 线程 池 关 型 多 线程 定时 器 固定 速率 


17:24:44 当前 序号 是 0 
24: i 1 


17:23:55 当前 序号 是 0 
17:23:55 当前 序号 是 1 
[17:23:55 当前 厚 号 是 2 
17:23:58 当前 序号 是 0 
17:23:58 当前 序号 是 1 
17:23:58 当前 序号 是 2 
17:24:01 当前 序号 是 0 
17:24:01 当前 序号 是 1 
[17:24:01 当前 序号 是 2 











图 16-19 单线 程 定时 器 线程 池 的 日 志 16-20 多 线程 定时 器 线程 池 的 日 志 


164 ”省 电 模式 


现在 手机 的 电池 容量 越 来 越 大 ， 电 量 消耗 的 速度 也 越 来 越 快 ， 往 往 使 用 一 两 天 手机 就 没 


ITE 
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同样 ， 


电 了 。 电 量 跟 流 量 是 用 户 很 关心 的 两 个 重要 指标 。 
一 个 App 若是 耗 电 大 户 ， 也 难以 逃脱 被 卸载 的 命运 。 所 以 App 开发 要 注意 适当 省 电 ， 


本 节 从 电量 检测 与 炸 屏 检测 两 方面 论述 如 何 开启 自 动 省 电 模 式 。 


16.4.1 检测 当前 电量 


-个 App 乱 跑 流量 ， 很 容易 遭 到 用 户 抛弃 ; 





Android 获取 当前 电量 是 通过 监听 广播 实现 的 。 具 体 地 说 ， 是 监听 电池 的 电量 改变 事件 ， 
即 Intent.ACTION_BATTERY_CHANGED。 因 为 接收 该 事件 要 求 App 处 于 活动 状态 ， 所 以 广 
播 接收 器 不 能 在 AndroidManifest.xml 中 注册 ， 只 能 在 代码 中 通过 registerReceiver 方法 动态 注 
册 。 注 册 完 成 即 可 监听 电量 变化 广播 ， 该 广播 携带 的 参数 信息 见 表 16-4。 


表 16-4 ”电量 变化 广播 中 携带 的 参数 信息 





















































BatteryManager 类 的 字段 名 称 说 明 
EXTRA SCALE getlntExtra 电量 刻度 ， 通 常 是 100 
EXTRA_LEVEL getlntExtra 当前 电量 
EXTRA_STATUS getlntExtra 当前 状态 
BATTERY_STATUS UNKNOWN 当前 状态 取 值 未 知 
BATTERY STATUS CHARGING 当前 状态 取 值 正在 充电 
BATTERY STATUS DISCHARGING 当前 状态 取 值 正在 断 电 
BATTERY STATUS NOT CHARGING 当前 状态 取 值 不 在 充电 
BATTERY STATUS FULL 当前 状态 取 值 电量 充满 
EXTRA_HEALTH getlntExtra 健康 程度 
BATTERY_HEALTH_UNKNOWN 健康 程度 取 值 未 知 
BATTERY HEALTH GOOD 健康 程度 取 值 良好 
BATTERY_HEALTH_OVERHEAT 健康 程度 取 值 过 热 
BATTERY HEALTH DEAD 健康 程度 取 值 KT 
BATTERY_HEALTH_OVER_VOLTAGE 健康 程度 取 值 短路 
BATTERY HEALTH UNSPECIFIED FAILURE | 健康 程度 取 值 未 知 错误 
BATTERY HEALTH COLD 健康 程度 取 值 冷却 
EXTRA_VOLTAGE getlntExtra 当前 电压 
EXTRA_PLUGGED getlntExtra 当前 电源 
0 当前 电源 取 值 电池 
BATTERY PLUGGED AC 当前 电源 取 值 充电 器 
BATTERY PLUGGED USB 当前 电源 取 值 USB 
BATTERY PLUGGED WIRELESS 当前 电源 取 值 无 线 
EXTRA TECHNOLOGY getStringExtra 当前 技术 ， 比 如 返回 Li-ion 
表示 锂电 池 
EXTRA_TEMPERATURE getlntExtra 当前 温度 
EXTRA_PRESENT getBooleanExtr 是 否 提供 电池 
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检测 当前 电量 的 代码 没什么 技术 含量 ， 只 是 简单 把 电量 变化 广播 中 携带 的 参数 信息 打印 


出 来 。 这 里 不 再 浪费 篇 幅 , 读者 可 参考 本 书 下 载 资源 中 的 相关 实现 。 电 量 检测 的 效果 如 
和 图 16-22 所 示 。 其 中 ， 图 16-21 所 示 为 正在 充电 时 的 界面 ， 图 16-22 所 示 为 拔 出 充 上 
界面 。 


performance performance 


18:17:07 : 收 到 广 18:17:23 : 收 到 广 


图 16-21 
电器 时 的 





播 : android.intent.action.BATTERY_CHANGE 播 : android intent action BATTERY. CHANGE. 
D D 


电量 刻度 =100 
当前 电量 =18 


当前 状态 = 正在 充电 
健康 程度 = 良好 


是 天 提供 电池 -是 
图 16-21 正在 充电 时 的 电量 信息 图 16-22 没 在 充电 时 的 电量 信息 
16.4.2 ”检测 屏幕 开关 





大 家 很 关心 如 何 给 App 减负 、 省 电 ， 前 人 也 做 了 不 少 总 结 工作 ， 基 本 的 判断 原则 是 : 越 


消耗 资源 的 App， 耗 电量 就 越 大 。 有 具体 到 代码 编写 主要 有 以 下 省 电 措施 : 

(1) 能 用 整 型 数 计算 就 不 用 浮 点 数 计算 。 

(2) 能 用 JSON 解析 就 不 用 XML 解析。 

(3) 能 用 网 络 定位 就 不 用 GPS 定位 。 

(4) 尽量 减少 大 文件 的 下 载 〈 如 先 压缩 再 下 载 、 缓 存 已 下 载 的 文件 ) 。 

(5) 用 完 系统 资源 要 及 时 回收 。 

(6) 能 用 线程 处 理 就 不 用 进程 处 理 。 

(7) 多 用 缓存 复 用 对 象 资源 。 如 屏幕 尺寸 只 需 获 取 一 次 ， 之 后 可 到 缓存 中 读 取 。 

(8) 能 用 定时 器 广播 就 不 用 后 台 常 驻 服务 。 

(9) 能 用 内 存 存储 就 不 用 文件 存储 。 

上 述 省 电 措施 虽然 有 效 ， 但 是 比 起 耗 电大 户 ， 还 是 小 巫 见 大 巫 。 在 实际 开发 中 
户 其 实 是 后 台 默 默 运 行 的 Service 服务 。 想 想 看 ， 手 机 待机 时 ， 屏 幕 都 不 亮 了 ， 手 机 
- 些 不 知 疲倦 的 Service 在 “ 昌 公 移 山 ”， 愚 公 也 是 要 吃饭 的 呀 。 


耗 电 大 
EDEA 





既然 如 此 ， 若 想 避 免 App 在 手机 待机 时 仍 在 做 无 用 功 ， 可 在 熄 屏 时 结束 指定 任务 ， 在 亮 
屏 时 再 开始 指定 任务 。 其 中 ,， 熄 屏 事 件 监 听 的 是 系统 广播 mtent.ACTION SCREEN ON, 2f 


事件 监听 的 是 系统 广播 Intent.ACTION_SCREEN_OFF。 








册 ， 就 不 起 任何 作用 。 


CD 炸 屏 事件 和 亮 屏 事件 必 须 在 代码 中 动态 注册 。 如 果 在 AndroidManifestxml 中 静态 注 
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(2) 在 熄 屏 时 ， 系 统 先 暂 停 所 有 活动 页 面 ， 然 后 才 关 闭 屏 幕 ; 同样 ， 在 亮 屏 时 ， 系 统 先 
点 亮 屏幕 ， 然 后 才 恢 复活 动 页 面 。 这 两 个 事件 不 能 在 Activity 代码 中 注册 和 注销 ， 只 能 在 自 定 
X. Application 类 的 onCreate 方法 中 注册 广播 接收 器 。 
(3) 活 动 页 面 要 想 得 知 屏幕 开关 的 事件 信息 , 必须 通过 自 定义 的 Application 类 间接 获取 。 
检测 屏幕 开关 事件 的 代码 如 下 : 
public class MainApplication extends Application { 
private static final String TAG = "MainApplication"; 
private static MainApplication mApp; 
private LockScreenReceiver mReceiver; 





private String mChange = ""; 


public static MainApplication getInstance() í 


return mApp; 

1 

public String getChangeDesc() í 
return mApp.mChange; 

; 


public void setChangeDesc(String change) í 
mApp.mChange = mApp.mChange + change; 


; 

(@Override 

public void onCreate() í 
super.onCreate(); 
mApp = this; 
mReceiver = new LockScreenReceiver(); 
IntentFilter filter = new IntentFilter(); 
filter.addAction(Intent. ACTION SCREEN ON); 
filter.addAction(Intent.ACTION SCREEN OFF); 
filter.addAction(Intent.ACTION USER PRESENT); 
registerReceiver(mReceiver, filter); 

h 

private class LockScreenReceiver extends BroadcastReceiver í 


@Override 
public void onReceive(Context context, Intent intent) { 
if (intent != null) { 
String change = ""; 
change = String.format("%s\n%s : 收 到 广播 "6s", change, 
Utils.getNowTime(), intent.getAction()); 
if (intent.getAction().equals(Intent.ACTION SCREEN ON)) í 
change = String.format("%sm 这 是 屏幕 点 亮 事件 ， 可 在 此 开启 日 常 操作 "， 
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change); 
} else if (intent.getAction().equals(IntenL ACTION SCREEN OFF)) ( 
change = String.format("%s\n 这 是 屏幕 关闭 事件 ， 可 在 此 暂停 耗 电 操作 "， 
change); 
} else if (intent.getAction() 
-equals(Intent.ACTION_USER_PRESENT)) í 
change = String.format("%s\n 这 是 用 户 解锁 事件 ", change); 
; 
Log.d(TAG, change); 
MainApplication.getInstance().setChangeDesc(change); 


j 
屏幕 检测 的 效果 如 图 16-23 所 示 , 能 够 正确 检测 到 熄 屏 事件 和 亮 屏 事件 ， 才 可 执行 后 台 服 
务 的 停止 与 启动 操作 。 


performance 


18:17:39 : 收 到 广 
ndroid.intent.action.SCREEN_OFF 


播 

这 是 屏幕 关闭 事件 ， 可 在 此 暂停 耗 电 操作 
18:17:43 : 收 到 广 

播 : android.intent.action.SCREEN_ON 
这 是 屏幕 点 亮 事件 ， 可 在 此 开启 日 常 操作 





16-23 ”测试 应 用 监测 到 了 熄 屏 事 件 和 亮 屏 事件 
165 KRMH: 图 片 缓存 框架 


性 能 优化 说 来 说 去 ， 归 根 到 底 是 用 最 少 的 资源 换取 最 高 的 效率 ， 也 就 是 看 哪个 性 价 比 最 
高 。 在 性 能 优化 的 诸多 措施 中 ， 性价比 最 高 的 当 数 图 片 缓存 ，App 要 想 既 好 看 又 丰富 ， 都 是 靠 
大 量 图 片 堆砌 出 来 的 。 与 其 纠结 HTTP 交互 文本 采用 JSON 格式 好 还 是 采用 XML 格式 好 ， 还 
不 如 好 好 研究 图 片 缓存 技术 , 一 张 图 片 的 运算 量 远 远 超过 一 段 文本 。 况且 图 片 缓存 不 但 可 以 加 
快运 行 速度 ， 而 且 能 节省 流量 ， 还 能 省 电 ， 从 而 极 大 改善 用 户 体验 。 本 章 以 “图 片 缓存 框架 ” 
实战 项 目 作为 结尾 。 





16.5.1 设计 思 
第 4 章 的 实战 项 目 “ 购 物 车 ”中 已 经 出 现 了 图 片 缓存 的 雏形 ， 当 时 的 图 片 缓存 只 有 两 级 ， 


即 “ 全 局 内 存 ” 一 “SD 卡 文件 ”。 实 际 开发 中 的 图 片 缓存 至 少 为 3 级 ， 即 “内 存 ” 一 “SD 
卡 ” 一 “网 络 ”。 正 常情 况 下 ，App 先 到 内 存 中 寻找 图 片 ， 如 果 找 到 ， 就 直接 显示 内 存 中 的 图 
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片 。 
经 过 


操作 


如 果 在 内 存 中 没 找到 图 片 ， 再 到 SD 卡 寻找 。 如 果 在 SD 卡 找到 图 片 ， 就 读 取 SD 卡 图 片 
示 。 如 果 在 SD 卡 也 没 找到 ， 就 得 根据 URL 去 网 络 下 载 图 片 ， 下 载 成 功 后 再 显示 图 片 。 
3 级 缓存 查找 ， 即 使 网 速 很 慢 甚 至 断 网 ，App 也 能 迅速 加 载 大 部 分 图 片 ， 使 得 用 户 的 浏览 
基本 不 受 影 响 。 

当然 ， 图 片 缓存 技术 主要 在 后 台 实 现 ， 普 通用 户 不 容易 感觉 到 它 的 存在 。 不 过 只 要 稍 加 
你 也 能 发 现 界面 上 采用 图 片 缓存 的 端倪 。 如 果 一 张 图 片 以 灰 度 动画 逐渐 显示 时 ,很 可 能 
通过 缓存 技术 加 载 的 。 图 16-24 和 图 16-25 分 别 展示 了 图 片 加 载 的 开始 与 完成 界面 ， 图 





16-24 中 的 玫瑰 花 尚且 有 腊 胱 胱 、 若 隐 若 现 ， 提 示 用 户 当前 图 片 正在 加 载 ， 加载 完毕 后 ， 整 张 


政 瑰 


为 了 
哪些 


象 也 














花 图 片 清晰 地 显示 出 来 ， 如 图 16-25 所 示 。 


performance performance 


占 位 加 载 列表 加 载 
月 坛 公园 的 玫瑰 花 盛开 啦 


占 位 加 载 列表 加 载 
月 坛 公园 的 玫瑰 花 盛开 啦 





图 16-24 玫瑰 花 图 片 正在 加 载 图 16-25 ”玫瑰 花 图 片 加 载 完成 
在 技术 上 ， 灰 度 动画 开始 时 ， 整 张 图 片 已 经 下 载 完 成 。 之 所 以 加 入 动画 的 渐变 效果 ， 是 
留 出 缓冲 的 过 程 ， 让 用 户 不 至 于 觉得 图 片 一 闪 一 内 很 突 元 。 接 下 来 看 图 片 缓存 框架 用 到 了 
App 技术 。 
(1) 图 像 视 图 ImageView: 无 论 多 么 高 深 的 框架 ， 都 要 打 好 基础 。 
(2) 灰 度 动画 AlphaAnimation: 通过 渐变 效果 展示 图 片 加 载 的 过 程 ， 用 到 了 灰 度 动画 。 
(3) 图 片 的 基本 加 工 : 有 时 为 了 减少 资源 占用 , 仅 需 展示 缩 略 图 , 用 户 有 需要 再 显示 大 图 。 
(4) 内 存 的 读 写 : 多 张 图 片 保 存在 缓存 队列 中 ， 要 求 有 合适 的 数据 结构 进行 管理 。 
(5) SD 卡 的 文件 读 写 : 从 网 络 下 载 的 图 片 先 保存 在 SD 卡 ， 再 依 情 况 决 定 是 否 加 载 进 内 存 。 
(6) HTTP 访问 : 从 网 络 获取 图 片 ， 可 直接 从 HTTP 地 址 读 取 图 片 数 据 。 
CD 多 线程 : 网 络 访问 请 求 ， 需 要 开局 分 线程 处 理 ， 并 操作 Handler 对 象 。 
(8) 线程 池 : 页 面 同时 请 求 多 张 图 片 ， 需 要 线程 池 统一 管理 图 片 下 载 的 各 线程 资源 。 
(9) 内 存 泄漏 频繁 操作 Handler 对 象 ， 要 及 时 释放 该 对 象 的 引用 。 另 外 ， 对 Bitmap 对 
要 注意 加 以 回收 。 


上 面 一 口气 列举 了 这 么 多 知识 点 ， 原 来 图 片 缓存 是 一 个 综合 技术 活 ， 可 算是 集 Android 技 





术 大 全 了 。 只 要 理解 图 片 缓存 的 算法 ， 并 加 以 实践 将 其 做 好 ， 就 差不多 可 以 掌握 半 部 App 的 
发 。 
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16.5.2 ”小 知识 :LRU 缓存 策略 


读者 也 许 还 记得 大 学 里 操作 系统 课程 中 的 页 面 置换 算法 ， 说 的 是 操作 系统 发 现 要 访问 的 
数据 在 内 存 中 找 不 到 , 只 好 把 内 存 中 很 久 没 用 的 页 面 踢 出 去 , 以 便 给 本 次 访问 的 数据 让 出 存储 
空间 ,图 片 缓存 的 排队 算法 类 似 页 面 置 换算 法 , 常见 的 主要 有 两 种 : FIFO 先进 先 出 算法 和 LRU 
最 久未 使 用 算法 。FIFO 算法 比较 容易 实现 ， 只 要 把 数据 按时 间 先 后 顺序 排队 ， 要 淘汰 老 旧 数 
据 时 ， 只 需 把 队列 最 前 端的 数据 移 除 即 可 。 因 为 图 片 缓存 的 FIFO 算法 需要 对 队列 两 端 进行 操 
作 ， 从 队列 顶端 移 除 淘汰 的 图 像 ， 并 把 新 增 的 图 像 加 到 队列 末端 ， 所 以 该 算法 的 缓存 结构 可 采 
用 双 端 队列 LinkedList。 

麻烦 的 是 LRU 算法 ， 虽 然 该 算法 在 实际 开发 中 用 得 最 多 ， 缓 存 效 果 也 最 好 ， 但 Java 却 没 
提供 该 算法 对 应 的 数据 结构 。 幸 好 Android 在 设计 之 初 已 经 考虑 了 该 问题 ， 提 供 了 LruCache 
缓存 工具 ， 方便 开发 者 实现 LRU 算法 的 相关 缓存 业务 。LruCache 内 部 集成 了 缓存 数据 的 插入 
时 间 判 断 , 无 论 缓 存 内 部 是 否 已 经 存在 某 键 值 ， 新 插入 的 键 数据 总 是 位 于 缓存 队列 尾部 ， 如 此 
开发 者 不 必 关 心 具 体 的 排队 淘汰 逻辑 ， 只 需 进 行 App 的 业务 处 理 就 好 。 

下 面 是 LruCache 的 常用 方法 说 明 。 


构造 函数 : 初始 化 指定 大 小 的 缓存 队列 。 
resize: 变更 缓存 队列 的 大 小 。 
put: 往 缓存 队列 插入 数据 。 
get: 从 缓存 队列 获取 数据 。 
remove: 把 指定 数据 移出 缓存 队列 。 
evictAll: 清空 缓存 队列 。 
size: 获得 已 使 用 的 缓存 队列 大 小 。 
maxSize: 获得 缓存 队列 的 总 大 小 。 
snapshot: 获得 缓存 队列 的 快照 ， 即 获取 缓存 队列 当前 的 映射 表 。 
可 以 看 出 ，LruCache 的 用 法 与 Java 的 容器 类 差不多 ， 但 有 两 个 不 同 点 值得 注意 一 下 : 
(1) LruCache 未 提供 contains 函数 用 于 判断 某 键 值 是 否 存在 ， 只 能 调用 get 函数 间接 判 
断 。 即 检查 get 函数 的 返回 值 ， 如 果 返 回 null 就 表示 缓存 中 不 存在 该 键 值 。 
(2) LruCache 不 能 直接 进行 遍历 操作 ， 只 能 调用 snapshot 函数 获得 当前 快照 ， 再 遍历 快 
照 中 的 映射 表 Map。 
接 下 来 通过 实际 代码 加 深 对 LruCache 的 理解 ， 示 例 代码 如 下 : 
public class LruCacheActivity extends AppCompatActivity implements OnClickListener í 


private TextView tv_lru_cache; 
private LruCache<String, String> mLanguageLru; 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
Super.onCreate(savedInstanceState); 
setContentView(R.layout.activity Iru cache); 
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tv_lru_cache = (TextView) findViewByld(R.id.tv_Iru cache); 
findViewById(R.id.btn android).setOnClickListener(this); 
findViewByld(R.id.btn ios).setOnClickListener(this); 
findViewById(R.id.btn java).setOnClickListener(this); 
findViewById(R.id.btn cpp).setOnClickListener(this); 
findViewById(R.id.btn python).setOnClickListener(this ); 
findViewByld(R.id.btn net).setOnClickListener(this); 
findViewById(R.id.btn php).setOnClickListener(this); 
findViewById(R.id.btn perl).setOnClickListener(this); 
mLanguageLru = new LruCache-String, String»(5); 

} 

@Override 

public void onClick(View v) { 
String language = ((Button) v).getText().toString(); 
mLanguageLru.put(language, Utils.getNowTime()); 


printCache(); 
J 
private void printCache() í 
String desc = ""; 
Map<String, String> cache = mLanguageLru.snapshot(); 
for (Map.Entry-String, String» item : cache.entrySet()) í 
desc = String.format("%s%s 最 后 一 次 更 新 时 间 为 %sm"， 
desc, item.getKey(), item.getValue()); 
J 
tv_lru cache.setText(desc); 
; 


j 

上 述 代码 运行 后 的 效果 如 图 16-26 一 图 16-29 所 示 。 其 中 , 图 16-26 所 示 为 LRU 缓存 在 某 
个 时 刻 的 快照 ， 此 时 Android 位 于 队列 顶端 ， 然 后 点 击 ANDROID 按钮 ， 表 示 现 在 已 访问 
Android， 于 是 Android 从 队列 顶端 移 到 了 队列 底部 ， 并 且 插 入 时 间 也 被 更 新 了 ， 此 时 队列 顶 
端的 数据 变 成 了 iOS， 如 图 16-27 所 示 。 





performance 
ANDROID 10S JAVA C/C++ 
PYTHON NET PHP PERL 


Android 最 后 一 次 更 新 时 间 为 17:05:01 
iOS 最 后 一 次 更 新 时 间 为 17:05:03 
JAVA 最 后 一 次 更 新 时 间 为 17:05:05 
C/C++ 最 后 一 次 更 新 时 间 为 17:05:07 
Python 最 后 一 次 更 新 时 间 为 17:05:09 





16-26 LRU 缓存 队列 里 的 初始 数据 





performance 
ANDROID Il0S JAVA C/C++ 
PYTHON NET PHP PERL 


iOS 最 后 一 次 更 新 时 间 为 17:05:03 
JAVA 最 后 一 次 更 新 时 间 为 17:05:05 
C/C++ 最 后 一 次 更 新 时 间 为 17:05:07 
Python 最 后 一 次 更 新 时 间 为 17:05:09 
Android 最 后 一 次 更 新 时 间 为 17:05:45 





图 16-27 点 击 Android 后 的 缓存 队列 


接着 点 击 PHP 按钮 ， 表 示 访 问 PHP 语言 ， 于 是 PHP 被 插入 到 缓存 队列 底部 ， 同 时 顶端 
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的 iOS 被 移出 队列 ， 此 时 队列 顶端 的 数据 变 成 了 JAVA， 如 图 16-28 所 示 。 然 后 点 击 JAVA 按 
钮 ， 表 示 访 问 Java 语言 ， 于 是 Java 从 队列 项 端 移 到 了 队列 底部 ， 而 且 更 新 了 插入 时 间 ， 此 时 
队列 顶端 的 数据 变 成 了 C/C++， 如 图 16-29 所 示 。 


performance performance 


ANDROID 10S JAVA ANDROID Ios 


PYTHON NET PHP PYTHON NET PHP 


JAVA 最 后 一 次 更 新 时 间 为 17:05:05 C/C++ 最 后 一 次 更 新 时 间 为 17:05:07 
Python 最 后 一 次 更 新 时 间 为 17:05:09 
Android 最 后 一 次 更 新 时 间 为 17:05:45 
PHP 最 后 一 次 更 新 时 间 为 17:07:15 

PHP 最 后 一 次 更 新 时 间 为 1707:15 JAVA 最 后 一 次 更 新 时 间 为 17:07:43 





图 16-28 点 击 PHP 后 的 LRU 缓存 队列 图 16-29 点 击 Java 后 的 LRU 缓存 队列 
16.5.8 ”代码 示例 


编码 与 测试 方面 需要 注意 以 下 3 点 : 
(1) AndroidManifest.xml 注意 声明 相关 权限 ， 举 例如 下 : 


<!-- 上 网 > 
<uses-permission android:name="android.permission.INTERNET" /> 
-sD F — 
<uses-permission android:name="android.permission.WRITE EXTERNAL STORAGE" /> 
<uses-permission android:name="android.permission.READ EXTERNAL STORAGE" /> 
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" > 
(2) 除了 普通 控件 的 图 片 缓存 ， 还 要 实现 列表 视图 里 的 图 片 缓存 。 因 为 ListView 只 会 加 
载 当 前 屏幕 上 可 见 的 列表 元 素 , 通过 不 断 上 拉 与 下 拉 ListView, 可 以 观察 图 片 缓存 是 否 正 常 工 
作 ， 以 及 是 否 发 生 内 存 泄漏 的 情况 。 
(3) 使 用 真 机 对 联网 与 断 网 两 种 情况 分 别 进行 测试 。 
最 后 是 图 片 缓存 框架 的 演示 时 间 ， 在 加 载 图 片 前 ， 通 常 在 原 图 位 置 放 一 张 占 位 图 片 ， 如 
图 16-30 所 示 。 如 果 图 片 加 载 失败 ， 就 在 原 图 位 置 显示 出 错 图 片 ， 提 示 用 户 原 图 加 载 失败 ， 如 
图 16-31 所 示 。 





占 位 加 载 列表 加 载 Simt 列表 加 载 
月 坛 公园 的 玫瑰 花 盛开 忱 Riz APO ES TP 


ET 
"m f s=. unser 











图 16-30 “加载 前 先 显示 占 位 图 片 16-31 加 载 失败 显示 出 错 图 片 
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在 联网 的 情况 下 ， 只 要 图 片 地 址 准确 ， 图 片 缓存 框架 便 能 正常 工作 。 一 旦 从 “内 存 ” 一 
“SD 卡 ” 一 “网 络 ”3 级 缓存 中 取 到 图 片 ， 便 可 通过 渐变 动画 在 页 面 展 示 图 片 。 如 图 16-32 
所 示 ， 此 时 动画 开始 ， 图 片 正 逐步 变 亮 ; 等 到 动画 结束 ， 图 片 揭 开 面纱 ， 完 全 呈现 出 来 ， 如 图 
16-33 所 示 。 














performance performance 
占 位 加 载 列表 加 载 占 位 加 载 列表 加 载 
月 坛 公园 的 玫瑰 花 盛开 啦 月 坛 公园 的 玫瑰 花 盛开 啦 
图 16-32 ”渐变 动画 正在 播放 图 16-33 ”渐变 动画 结束 播放 


再 来 看 图 片 缓存 在 列表 视图 中 是 如 何 工作 的 。 如 图 16-34 所 示 ， 一 打开 ListView 图 片 列 
表 页 面 , 处 于 屏幕 可 视 区 域 的 前 两 张 图 片 就 开始 加 载 ; 待 加 载 完毕 , 这 两 张 图 片 清晰 展现 开 来 ， 
如 图 16-35 所 示 。 

然后 把 页 面 拉 到 底部 ， 原 本 处 于 不 可 见 区 域 的 最 后 两 项 开始 加 载 ， 图 片 逐 渐变 亮 ， 如 图 
16-36 所 示 ; 最 终 这 两 张 图 片 完 整 无 缺 地 显示 出 来 ， 如 图 16-37 所 示 。 


performance 





占 位 加 载 列表 加 载 占 位 加 载 列表 加 载 
欢迎 来 到 风景 秀美 的 鼓浪屿 欢迎 来 到 风景 秀美 的 鼓浪屿 














图 16-34 ”列表 视图 头 部 图 片 开始 加 载 图 16-35 列表 视图 头 部 图 片 结束 加 载 
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performance 


performance 


点 位 加 载 列表 加 载 
欢迎 来 到 风景 秀美 的 鼓浪屿 — 

Wp: nam 

s - 
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=== ccm - =. 
图 16-36 ”列表 视图 底部 图 片 开 始 加 载 图 16-37 列表 视图 底部 图 片 结束 加 载 


看 起 来 是 不 是 很 神奇 ? 图 片 缓存 框架 的 用 法 很 简单 ， 先 设置 好 各 项 缓存 的 处 理 参数 ， 然 
后 调用 show 方法 即 可 。 下 面 是 该 缓存 框架 的 调用 代码 示例 : 

ImageCacheConfig config = new ImageCacheConfig.Builder() 
.setBeginImage(R.drawable.load_default) ”// 设 置 初始 图 片 
.setErrorImage(R.drawable.load_error) // 设 置 出 错 图 片 
.setCacheStyle(ImageCacheConfig.LRU) ”// 设 置 LRU 缓存 算法 
-setFadelnterval(2000).build(); // 设 置 渐变 动画 的 持续 时 间 

// 初 始 化 缓存 设置 ， 并 把 地 址 为 file 的 图 片 显示 到 控件 iv cache 上 

mCache.initConfig(config).show(file, iv cache); 

图 片 缓存 框架 的 核心 处 理 代码 如 下 : 

public class ImageCache { 
private final static String TAG = "ImageCache"; 
// 内 存 中 的 图 片 缓 存 
private Hash Map<String, Bitmap» mImageMap = new Hash Map<String, Bitmap>(); 
/luri 与 视图 控件 的 映射 关系 
private HashMap<String, ImageView> mViewMap = new Hash Map<String, ImageView>(); 
/缓存 队列 ， 采 用 FIFO 先进 先 出 策略 ， 需 操作 队列 首尾 两 端 ， 故 采用 双 端 队列 
private LinkedList<String> mFifoList = new LinkedList<String>(); 
// 缓 存 队列 ， 采 用 LRU 近期 最 少 使 用 策略 ，Android 专门 提供 了 LruCache 实现 该 算法 
private LruCache<String, Bitmap> mlmageLru; 








private ImageCacheConfig mConfig; 
private String mDir = ""; 

private ThreadPoolExecutor mPool; 
private static Handler mMyHandler; 
private static ImageCache mCache = null; 
private static Context mContext; 


public static ImageCache getInstance(Context context) í 
if (mCache = null) í 
mCache = new ImageCache(); 
mCache.mContext = context; 
ji 


return mCache; 


public ImageCache initConfig(ImageCacheConfig config) { 
mCache.mConfig = config; 
mCache.mDir = mCache.mConfig.mDir; 
if (mCache.mDir==null || mCache.mDir.length()<=0) í 
mCache.mDir = Environment.getExternalStorageDirectory() + "/image_cache"; 
J 
Log.d(TAG, "mDir="+mCache.mDir); 
File dir = new File(mCache.mDir); 
if (dir.exists() != true) í 
dirmkdirs); / 车 目录 不 存在 ， 则 先 创建 新 目录 
J 
mCache.mPool = (ThreadPoolExecutor) Executors.newFixedThreadPool 
(mCache.mConfig.mThreadCount); 
mCache.mMyHandler = new MyHandler((Activity)mCache.mContext); 
if (mCache.mConfig.mCacheStyle — ImageCacheConfig.LRU) í 
mlmageLru = new LruCache(mCache.mConfig.mMemoryFileCount); 
j 


return mCache; 


public void show(String uri, ImageView iv) í 

if (mConfig.mBeginImage != 0) í 
iv.setImageResource(mConfig.mBeginImage); 

; 

mViewMap.put(uri, iv); 

if (checkExist(uri) — true) í 
mCache.render(uri, getBitmapturi)); 

} else í 
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String path = getFilePath(uri); 

if ((new File(path)).exists() — true) í 
Bitmap bitmap = ImageUtil.openBitmap(path); 
if (bitmap != null) í 


mCache.render(uri, bitmap); 
) else ( 
mPool.execute(new MyRunnable(uri)); 
j 
} else í 


mPoolL.execute(new MyRunnable(uri)); 


private boolean checkExist(String uri) í 
if (mCache.mConfig.mCacheStyle — ImageCacheConfig.LRU) í 
return (mImageLru.get(uri)——null)?false:true; 
) else { 
return mlmageMap.containsKey(uri); 


private Bitmap getBitmap(String uri) í 
if (mCache.mConfig.mCacheStyle = ImageCacheConfig.LRU) í 
return mImageLru.get(uri); 
) else { 
return mImageMap.get(uri); 


private String getFilePath(String uri) í 
String file path = String.format("%s/%d.jpg", mDir, uri.hashCode()); 
return file path; 


private static class MyHandler extends Handler í 
public static WeakReferencecActivity^ mActivity; 
public MyHandler(Activity activity) í 
mActivity = new WeakReference-Activity^(activity); 


(GQOverride 
public void handleMessage(Message msg) í 
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Activity act = mActivity.get(); 
if (act != null) í 
ImageData data = (ImageData) (msg.obj); 
if (data!=null && data.bitmap!=null) í 
mCache.render(data.uri, data.bitmap); 
) else í 
mCache.showError( data.uri ; 


private class MyRunnable implements Runnable í 
private String mUri; 
public MyRunnable(String uri) í 
müUri = uri; 


@Override 
public void run() { 
Activity act = MyHandler.mActivity.get(); 
if (act != null) í 
Bitmap bitmap = ImageHttp.getlmage(mUri); 
if (bitmap != null) { 
if (mConfig.mSize != null) { 
bitmap = Bitmap.createScaledBitmap(bitmap, mConfig.mSize.x, 
mConfig.mSize.y, false); 
j 
ImageUtil.saveBitmap(getFilePath(mUri), bitmap); 
j 
ImageData data = new ImageData(mUri, bitmap); 
Message msg = mMyHandler.obtainMessage(); 
msg.obj = data; 
mMyHandler.sendMessage(msg); 


B 


private void render(String uri, Bitmap bitmap) { 
ImageView iv = mViewMap.get(uri); 
if (mConfig.mFadelnterval <= 0) í 
iv.setImageBitmap(bitmap); 
}else{ 
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/内 存 中 已 有 图 片 的 就 直接 显示 ， 不 再 展示 淡 入 淡出 动画 
if (checkExist(uri) — true) í 
iv.setImageBitmap(bitmap); 
} else í 
iv.setAlpha(0.0f); 
AlphaAnimation alphaAnimation = new AlphaAnimation(0.0f, 1.0f); 
alphaAnimation.setDuration(mConfig.mFadelnterval); 
alphaAnimation.setFillA fter(true); 
iv.setImageBitmap(bitmap); 
iv.setAlpha(1.0f); 
iv.setAnimation(alphaAnimation); 
alphaAnimation.start(); 
mCache.refreshList(uri, bitmap); 


private synchronized void refreshList(String uri, Bitmap bitmap) í 
if (mCache.mConfig.mCacheStyle == ImageCacheConfig.LRU) í 
mlImageLru.put(uri, bitmap); 
) else ( 
if (mFifoList.size() >= mConfig.mMemoryFileCount) í 
String out_uri = mFifoList.pollFirst(); 
mlmageMap.remove(out_uri); 
J 
mlmageMap.put(uri, bitmap); 
mFifoList.addLast(uri); 


private void showError(String uri) í 
ImageView iv = mViewMap.get(uri); 
if (mConfig.mErrorlmage != 0) í 
iv.setImageResource(mConfig.mErrorImage); 


public void clear() í 
for (Map.Entry<String, Bitmap> item map : mlImageMap.entrySet()) í 
Bitmap bitmap = item map.getValue(); 
bitmap.recycle(); 
$ 
if (mImageLru != null) í 
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166 小 结 


本 章 主 要 介绍 了 App 开发 用 到 的 常见 性 能 优化 技术 ,包括 布局 文件 优化 〈 减 少 重 复 布局 、 
自 适 应 调整 布局 、 自 定义 窗口 主题 ) 、 内 存 泄 漏 处 理 〈 内 存 泄漏 的 检测 、 内 存 泄漏 的 预防 ) 、 
线程 池 管 理 〈 普 通 线程 池 、 定 时 器 线程 池 ) 、 省 电 模式 〈 检 测 当前 电量 、 检 测 屏幕 开关 ) 。 最 
后 设计 了 一 个 实战 项 目 “ 图 片 缓存 框架 ”， 在 该 项 目的 App 编码 中 采用 了 本 书 讲述 的 与 存储 
和 多 线程 有 关 的 主要 技术 。 另 外 ， 介 绍 了 LRU 缓存 策略 的 原理 与 用 法 。 

通过 本 章 的 学 习 ， 读 者 应 该 能 够 掌握 以 下 4 种 开发 技能 : 


CD. 学 会 使 用 布局 文件 优化 技术 统一 界面 风格 。 

(2) 学 会 检测 内 存 泄漏 的 情况 ， 并 采取 相应 的 预防 措施 。 
(3) 学 会 有 效 使 用 和 管理 线程 池 。 

(4) 学 会 图 片 缓存 框架 的 基本 原理 和 具体 实现 。 


